Listar facturas de comisiones de una cuenta conectada

GET

https://app.recurrente.com/api/connected_accounts/:connected_account_id/commission_invoices

GET

/api/connected_accounts/:connected_account_id/commission_invoices

$ curl https://app.recurrente.com/api/connected_accounts/connected_account_id/commission_invoices \
>      -H "X-SECRET-KEY: <apiKey>"

1 [
2   {
3     "id": "pci_ab12cd34",
4     "connected_account_id": "ac_restaurant",
5     "status": "draft",
6     "billing_date": "2026-07-13",
7     "currency": "GTQ",
8     "amount_in_cents": 325,
9     "description": "Comisiones de plataforma del 13/07/2026",
10     "created_at": "2024-01-15T09:30:00Z",
11     "updated_at": "2024-01-15T09:30:00Z",
12     "fee_in_cents": 25,
13     "tax_invoice_uuid": "string",
14     "tax_invoice_url": "string",
15     "issued_at": "2024-01-15T09:30:00Z",
16     "lines": [
17       {
18         "transfer_setup_id": "string",
19         "transfer_id": "string",
20         "source_id": "string",
21         "source_type": "Checkout",
22         "amount_in_cents": 1,
23         "currency": "GTQ",
24         "completed_at": "2024-01-15T09:30:00Z",
25         "created_at": "2024-01-15T09:30:00Z"
26       }
27     ]
28   }
29 ]

Lista los documentos diarios, más recientes primero. La lista no incluye las líneas; consulta el documento individual para reconciliar cada transferencia de origen. El emisor conserva acceso a este historial si la cuenta deja de estar conectada.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`.

Path parameters

connected_account_idstringRequired

ID de la cuenta conectada

Query parameters

pageintegerOptional>=1Defaults to 1

Número de página (empezando en 1)

itemsintegerOptional1-100Defaults to 10

Elementos por página

Response

Lista de facturas de comisiones

idstring

ID de la factura diaria de comisiones

connected_account_idstring

Cuenta conectada que debe pagar la comisión

statusenum

Estado durable del documento fiscal

billing_datedate

Día económico en America/Guatemala

currencyenum

amount_in_centsinteger>=1

Suma exacta de las comisiones incluidas, en centavos

descriptionstring

created_atdatetime

updated_atdatetime

fee_in_centsinteger or nullOptional

Fee FEL debitado a la plataforma después de una emisión exitosa

tax_invoice_uuidstring or nullOptional

UUID del DTE emitido por INFILE

tax_invoice_urlstring or nullOptionalformat: "uri"

URL del DTE emitido

issued_atdatetime or nullOptional

lineslist of objectsOptional

Solo se incluye en el endpoint de detalle

Errors

404

Not Found Error