---
title: "Obtener Subscription"
method: GET
path: "/subscriptions/{encrypted_subscription_id}"
tags: ["Subscriptions"]
---

# Obtener Subscription

`GET /subscriptions/{encrypted_subscription_id}`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/subscriptions/{encrypted_subscription_id}`
- Auth: API key in header `x-api-key`

Devuelve una Subscription a partir de su identificador público.

Entrega el detalle de la Subscription, incluyendo su configuración de recurrencia cuando corresponde. Responde `404` si la Subscription no existe o no pertenece a la organización y Account autenticadas.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Path parameters

- `encrypted_subscription_id` string, required: Identificador público de la Subscription (`sub_...`).

## Headers

- `x-account-key` string: Llave de API de una Account, para operar sobre esa Account en lugar de la principal.
- `x-api-version` string, date: Versión del API para esta petición, como cualquier fecha `YYYY-MM-DD`. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

## Response `200`

Successful Response

- Subscription: Producto o servicio que la organización le presta a un Customer, y el vínculo por el que se le cobra. Las Invoices dependen siempre de una Subscription: si es recurrente, Toku las genera por su cuenta según la recurrencia configurada; si no lo es, las carga la organización. El `product_id` identifica a la Subscription dentro de la Account de cobro y no se repite en ella, así que sirve para referenciarla sin conocer su identificador de Toku.
  - `amount` number: Monto de las deudas generadas por la suscripción, expresado en la moneda indicada por `currency_code`.
  - `currency_code` 'CLP' | 'CLF' | 'MXN' | 'BRL' | 'USD': Moneda, en código [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Cubre las monedas de los países donde Toku opera —`CLP` (peso chileno), `MXN` (peso mexicano) y `BRL` (real)— más `USD` y `CLF`, la Unidad de Fomento chilena. La moneda determina cuántos decimales admiten los montos: `CLP` no admite decimales, `MXN`, `BRL` y `USD` admiten dos, y `CLF` cuatro.
  - `customer` string, required: Identificador público del cliente dueño de la suscripción.
  - `due_day` integer: Día de vencimiento de las deudas. Para las frecuencias mensual y anual es el día del mes (1–31); para la semanal, el día de la semana (1 = lunes).
  - `id` string, required: Identificador público de la suscripción.
  - `id_account` string, required: Identificador público de la cuenta a la que pertenece la suscripción.
  - `is_recurring` boolean: Indica si la suscripción es recurrente, es decir, si genera deudas de forma periódica y automática.
  - `metadata` object: Campos adicionales definidos por la organización para la suscripción.
  - `pac_mandate_id` string: Identificador del mandato PAC asociado a la suscripción.
  - `product_id` string, required: Identificador del producto de la organización asociado a la suscripción.
  - `receipt_product_code` string: Código de producto usado al emitir el documento tributario de la suscripción.
  - `recurring` RecurringSubscriptionDataResponse: Configuración de recurrencia de una suscripción.
    - `amount` number: Monto de cada deuda recurrente, expresado en la moneda de la suscripción.
    - `anchor` string, date: Fecha ancla del ciclo de facturación desde la cual se calculan los períodos de recurrencia.
    - `creation_lead_days` integer: Días de anticipación con los que se crea cada deuda antes de su fecha de vencimiento.
    - `due_day` integer: Día de vencimiento de las deudas. Para las frecuencias mensual y anual es el día del mes (1–31); para la semanal, el día de la semana (1 = lunes).
    - `end_date` string, date: Fecha hasta la cual la suscripción genera deudas. Si es null, la recurrencia no tiene fecha de término.
    - `frequency` 'daily' | 'weekly' | 'monthly' | 'yearly': Frecuencia del ciclo de cobro.
    - `interval` integer: Número de unidades de `frequency` entre cada deuda (por ejemplo, un `interval` de 2 con `frequency` mensual genera una deuda cada dos meses).
    - `max_active_invoices` integer: Número máximo de deudas activas (impagas) que la recurrencia mantiene de forma simultánea.
    - `status` 'ACTIVE' | 'PAUSED' | 'FINISHED': Estado del ciclo de vida de las reglas de cobro de una Subscription recurrente.

## Other responses

- `401`: Falta de credenciales.
- `403`: Falta de permisos. No tienes por qué estar ahi 👀.
- `404`: El recurso no fue encontrado.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Superaste el número máximos de request permitidos, espera un poquito.

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)