List invoices
Invoices with number, account, state, totals and dates.
MCP tool recurly_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recurly_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
},
"isError": false
}