---
title: "Listar planes"
method: GET
path: "/subscriptions/plans"
tags: ["Subscripciones", "Subscriptions"]
---

# Listar planes

`GET /subscriptions/plans`

Lista todos los planes creados hasta la fecha.

## Parameters

- `#/paths/~1/get/parameters/0` — unresolved $ref

## Response `200`

OK

- object
  - `message` string, required — Nombre del código HTTP de respuesta.
  - `code` number, required — Código de respuesta.
  - `current_time` string, required — Fecha y hora de la petición.
  - `plan` Plan[]
    - `amount` number, required — Cantidad a cobrar, en la moneda fraccionaria elegida. Una cantidad de 100 utilizando la moneda Euro es igual a 1€.
    - `created_at` Created, required — unresolved $ref
    - `external_id` string, required — ID externo otorgado por el comercio para identificar de forma única a un plan.
    - `interval` number, required — Intervalo en la unidad indicada en el campo `interval_type` que determina cada cuánto tiempo debe cobrarse la subscripción.
    - `interval_offset` number — Intervalo en la unidad indicada en el campo `interval_offset_type` que determina la unidad de tiempo que dura el periodo de prueba de la subscripción.
    - `interval_offset_type` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Unidad de tiempo que determina la unidad de tiempo que dura el periodo de prueba de la subscripción. Requerido si se indica el campo `interval_offset`.
    - `interval_type` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — Unidad de tiempo que determina la unidad de tiempo que dura el periodo de prueba de la subscripción. Requerido si se indica el campo `interval_offset`.
    - `name` string, required — Nombre del plan.
    - `product` Product, required — El producto de la subscripción. A esta entidad se asocian planes.
      - `created_at` Created, required — unresolved $ref
      - `external_id` string, required — ID externo otorgado por el comercio para identificar de forma única a un producto.
      - `name` string, required — Nombre del producto.
      - `notification_url` string — URL que recibirá una notificación HTTP cuando el pago cambie de estado.
      - `sandbox` boolean, required — Indica sí el producto pertenece al entorno de sandbox.
      - `updated_at` UpdatedAt, required — unresolved $ref
    - `trial_available` boolean — Por defecto, false. Indica si hay periodo de prueba. Hasta que éste no termine no se realizará el primer cobro.
    - `updated_at` string, required — Fecha de última actualización de la entidad.

---

[API](https://skmtc.net/paylands/apis/documentacio-n-de-paylands.md) · [All operations](https://skmtc.net/paylands/apis/documentacio-n-de-paylands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylands/documentacio-n-de-paylands/revisions/6bf9c0ba354b/schema)