TRtrytoku
Invoices

Listar Invoices cobrables

Changed on

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.

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

Query parameters

page_sizeinteger

Cantidad máxima de elementos por página (entre 1 y 100).

Example:50
next_cursorstring

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-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

x-api-versionstring 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.

Example:2026-10-08

Response

Página de Invoices en estado cobrable.

next_cursorstring required

Example response

{
  "items": [
    {
      "account": "acc_gzD0XoUTFxbUFcItpWOCqN686noSd9HQ",
      "amount": 19990,
      "customer": "cus_ejC08yLqOWoFhVx4Fx42E3IR9X50tNx2",
      "due_date": "2025-03-10",
      "expiration_date": "2025-03-10T03:00:00Z",
      "id": "in_9K0bTq3xR7yA2sVpLmZ4wE1nHdJf6UcQ",
      "invoice_external_id": "F-2025-000123",
      "link_payment": "https://portal.pagos.com/tu-empresa",
      "max_collection_attempts": 3,
      "metadata": {
        "sucursal": "Providencia"
      },
      "product_id": "plan-oro-marzo-2025",
      "receipt_type": "bill",
      "remaining_collection_attempts": 3,
      "source": "integration_etl",
      "subscription": "sub_Y_EgOXMloD5-IJn6d9S2IxkNvp9p0iiP"
    }
  ]
}

Changes