---
title: "Obtener una lista de suscripciones"
method: GET
path: "/api/v1/merchants/subscriptions"
tags: ["Suscripciones"]
---

# Obtener una lista de suscripciones

`GET /api/v1/merchants/subscriptions`

Este endpoint permite consultar una lista de suscripciones existentes, aplicando filtros opcionales como estado, plan asociado, correo del usuario, entre otros. Es útil para administrar y supervisar suscripciones de forma eficiente.

## Query parameters

- `plan_code` string
- `status` 'pending' | 'active' | 'canceled' | 'expired'
- `user_email` string
- `page` integer
- `size` integer

## Headers

- `X-API-key` string, required

## Response `200`

Lista de suscripciones obtenida exitosamente.

- object
  - `data` SubscriptionList[] — Lista de suscripciones.
    - Subscription[]
      - `activated_at` string, date-time — Fecha de activación.
      - `auto_renew` boolean — Indica si la suscripción se renueva automáticamente.
      - `canceled_at` string, date-time — Fecha de cancelación.
      - `created_at` string, date-time — Fecha y hora de creación.
      - `currency` string — Moneda de la suscripción.
      - `current_period_ends_at` string, date-time — Fin del periodo actual.
      - `current_period_started_at` string, date-time — Inicio del periodo actual.
      - `expires_at` string, date-time — Fecha de expiración.
      - `payer_info` object — Información del usuario asociado.
        - `email` string — Correo electrónico del usuario.
        - `user_id` string — ID único del usuario.
      - `plan_code` string — Código del plan asociado.
      - `remaining_billing_cycles` integer — Ciclos de facturación restantes.
      - `status` string — Estado inicial de la suscripción.
      - `subscription_id` string, uuid — ID único de la suscripción creada.
      - `total_billing_cycles` integer — Número total de ciclos de facturación.
      - `updated_at` string, date-time — Fecha de última actualización.
  - `page` integer — Número de la página actual.
  - `size` integer — Tamaño de la página.

## Other responses

- `400` — Respuesta de un bad request
- `401` — Respuesta de una solicitud **sin autorización** este problema es debido a el **X-API-KEY** inválido o por el **Bearer-Auth
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)