---
title: "Listar Invoices cobrables"
method: GET
path: "/invoices/chargeable"
tags: ["Invoices"]
---

# Listar Invoices cobrables

`GET /invoices/chargeable`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/invoices/chargeable`
- Auth: API key in header `x-api-key`

Devuelve las Invoices que pueden cobrarse en este momento, paginadas.

Se usa para armar una corrida de cobro: entrega solo las Invoices en estado cobrable y excluye las pagadas, anuladas y no cobrables. El orden es estable entre páginas gracias al cursor de paginación.

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

## Query parameters

- `page_size` integer: Cantidad máxima de elementos por página (entre 1 y 100).
- `next_cursor` string: Cursor de la página siguiente. Envía el `next_cursor` devuelto en la respuesta anterior para continuar; omítelo en la primera llamada.

## 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`

Página de Invoices en estado cobrable.

- ListInvoices
  - `items` DTOInvoice[], required
    - `account` string: Identificador público de la Account de cobro a la que pertenece la Invoice.
    - `amount` number: Monto adeudado, expresado en la moneda indicada en `currency_code`. La cantidad de decimales admitida la define la moneda: CLP no acepta decimales, MXN y BRL aceptan 2, y CLF acepta 4.
    - `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 Customer dueño de la Invoice.
    - `disable_automatic_payment` boolean: Indica si la Invoice está excluida del cobro automático. Permite cargarla sin que se mande a cobrar aunque el Customer tenga un método de pago automático activo.
    - `due_date` string, required: Fecha de vencimiento de la Invoice, en formato `YYYY-MM-DD`.
    - `expiration_action` 'EXPIRE' | 'VOID' | 'DELETE': Acción que se ejecuta sobre una Invoice cuando expira: marcarla como expirada (`EXPIRE`), anularla (`VOID`) o eliminarla (`DELETE`). `EXPIRE` es legado: se mantiene por compatibilidad, pero deja la Invoice en el estado `EXPIRED`, que está deprecado. Para nuevas integraciones usa `VOID` o `DELETE`.
    - `expiration_date` string, date-time: Fecha y hora de expiración de la Invoice. A partir de ese momento no se realizan más intentos de cobro.
    - `general_status` string, required: Estado general de la deuda de cara al cliente, derivado de su estado interno. Valores posibles: `paid`, `partially_paid`, `unpaid`, `void`, `expired`.
    - `id` string, required: Identificador público de la Invoice.
    - `id_receipt` integer: Identificador del recibo asociado a la Invoice.
    - `in_progress` boolean, required: Indica si la deuda tiene un cobro en curso, es decir, un pago que aún no se confirma ni se rechaza.
    - `invoice_external_id` string: Identificador único de la deuda externo a Toku. Permite distinguir dos Invoices del mismo producto que vencen el mismo día.
    - `is_paid` boolean: Indica si la Invoice está pagada.
    - `is_void` boolean: Indica si la Invoice está anulada. Las Invoices anuladas se tratan como si hubiesen sido borradas.
    - `link_payment` string: URL donde se debe pagar la Invoice. Se deja vacía para usar el portal de pagos de Toku; se completa solo si se desea utilizar un procesador de pagos externo.
    - `max_collection_attempts` integer: Cantidad máxima de intentos de cobro antes de que la Invoice expire.
    - `metadata` object: Valores adicionales definidos por la organización. Se tratan como texto y no pueden superar los 256 caracteres cada uno. Deben declararse en la webapp de Toku antes de poder usarse.
    - `paid_amount` number: Monto ya pagado de la Invoice. Se usa para reflejar pagos parciales.
    - `product_id` string, required: Identificador interno del producto que genera la Invoice. Puede ser un número de contrato o de propuesta.
    - `receipt_type` string: Tipo de recibo a emitir para la Invoice: `bill` (boleta), `invoice` (factura) o `no_receipt` (sin recibo).
    - `refund_data` RefundData
      - `id_transaction_payment` string, required
      - `id_transaction_refund` string, required
      - `refund_amount` number, required
      - `refund_reason` string, required
      - `refund_status` 'success' | 'failed', required: Resultado de la devolución asociada a una Invoice.
    - `remaining_collection_attempts` integer: Intentos de cobro que quedan disponibles. Se reinicia por completo si cambia `max_collection_attempts`.
    - `source` string: Origen desde el que se creó la Invoice, por ejemplo una carga masiva, una integración o una Subscription recurrente. Es nulo cuando no se informó al crearla.
    - `status` 'DELETED' | 'VOID' | 'UNPAID' | 'PAID' | 'PARTIALLY_PAID' | 'EXTERNALLY_PAID' | 'UNPAID_PAYMENT_IN_PROGRESS' | 'PARTIALLY_PAID_PAYMENT_IN_PROGRESS' | 'UNPAID_NON_BLOCKING_PAYMENT_IN_PROGRESS' | 'PARTIALLY_PAID_NON_BLOCKING_PAYMENT_IN_PROGRESS' | 'UNPAID_PARTIAL_PAYMENT_IN_PROGRESS' | 'PARTIALLY_PAID_PARTIAL_PAYMENT_IN_PROGRESS' | 'EXPIRED', required: Estado detallado de una Invoice. Combina el avance del pago (sin pagar, parcialmente pagada, pagada) con la existencia de un cobro en curso, y cubre además los estados terminales de anulación y eliminación. `EXPIRED` está deprecado: solo lo alcanzan las Invoices con acción de expiración `EXPIRE`.
    - `subscription` string, required: Identificador público de la Subscription a la que pertenece la Invoice.
  - `next_cursor` string, required

## 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.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/invoices/chargeable/get.md)

---

[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)