List invoices
Invoices with number, account, state, totals and dates.
GET https://cotlet.dev/api/v1/recurly/invoices
read
Lists invoices, 50 per page by default and up to 200. Filter by state: open, collected, failed or past_due. Each invoice has exactly one state. Totals are in cents with the currency, and each item has the invoice_number used by get_invoice and refund_invoice.
Parameters
| Name | Type | Description |
|---|---|---|
| state enum | enum | open, collected, failed or past_due. Default: all. |
| per_page integer | integer | 1 to 200. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/recurly/invoices \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recurly", "list_invoices")const result = await cotlet.call('recurly', 'list_invoices');cotlet call recurly list_invoicesExample response
{
"invoices": [
{
"invoice_number": "1042",
"account_code": "acme-co",
"state": "past_due",
"subtotal_in_cents": 24000,
"tax_in_cents": 0,
"total_in_cents": 24000,
"currency": "USD",
"created_at": "2026-09-06T07:00:00Z"
},
{
"invoice_number": "1077",
"account_code": "bright-lab",
"state": "past_due",
"subtotal_in_cents": 9900,
"tax_in_cents": 0,
"total_in_cents": 9900,
"currency": "USD",
"created_at": "2026-09-21T07:00:00Z"
}
],
"total": 2,
"next_cursor": null
}