---
title: "Obtener una lista de planes"
method: GET
path: "/api/v1/merchants/plans"
tags: ["Planes"]
---

# Obtener una lista de planes

`GET /api/v1/merchants/plans`

Este endpoint proporciona una lista de planes de suscripción registrados, permitiendo aplicar filtros como estado (activo/inactivo) o etiquetas personalizadas. Es ideal para obtener una vista general o específica de los planes disponibles en el sistema.

## Query parameters

- `tag` string
- `status` 'active' | 'inactive'
- `page` integer
- `size` integer

## Headers

- `X-API-key` string, required

## Response `200`

Lista de planes obtenida exitosamente.

- object
  - `data` Plan[] — Lista de planes.
    - `amount` number — Precio del plan por ciclo de facturación. Debe expresarse en céntimos, por ejemplo si el importe es de 19,99 dólares se representará como 1999 que significa 19 dólares céntimos.
    - `auto_renew` boolean — Indica si el plan se renueva automáticamente.
    - `currency` string — Moneda en la que se cobrará el plan. Debe expresarse en céntimos, por ejemplo si el importe es de 10,00 dólares se representará como 1000 que significa 10 dólares 0 céntimos.
    - `description` string — Descripción del plan.
    - `interval_length` integer — Longitud del intervalo de facturación.
    - `interval_unit` string — Unidad de tiempo para el intervalo de facturación.
    - `merchant_id` string — ID único del comercio.
    - `name` string — Nombre del plan.
    - `plan_code` string — Código único del plan.
    - `price_model` string — Modelo de precios del plan.
    - `setup_fee` number — Cargo inicial para el plan.
    - `tags` string[] — Etiquetas asociadas al plan.
    - `total_billing_cycles` integer — Número total de ciclos de facturación.
  - `page` integer — Número de la página actual.
  - `size` integer — Tamaño de la página.

## Other responses

- `401` — Respuesta de una solicitud **sin autorización** este problema es debido a el **X-API-KEY** inválido o por el **Bearer-Auth

---

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