List invoices
Sales invoices with number, client, dates, status, total and balance, filtered by status, client or due date.
MCP tool alegra_read → list_invoices
read
Lists sales invoices, newest page first as Alegra returns them. Status is one of open, closed, draft or void. Each item shows the total, the amount already paid and the balance, so overdue invoices can be told from paid ones. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open, closed, draft or void. Several can be given, separated by commas. |
| client_id string | string | Only invoices of this contact. |
| due_before date | date | Only invoices due before this date, YYYY-MM-DD. |
| date_from date | date | Only invoices dated on or after this day, YYYY-MM-DD. |
| date_to date | date | Only invoices dated on or before this day, YYYY-MM-DD. |
| limit integer | integer | Invoices per page. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "alegra_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "1038",
"number": "FV-0038",
"client": {
"contact_id": "20",
"name": "Northwind Studio"
},
"date": "2026-09-15",
"due_date": "2026-09-30",
"status": "open",
"currency": "USD",
"total": 1130.5,
"total_paid": 0,
"balance": 1130.5
},
{
"invoice_id": "1035",
"number": "FV-0035",
"client": {
"contact_id": "27",
"name": "Lumen Dental"
},
"date": "2026-09-07",
"due_date": "2026-09-22",
"status": "open",
"currency": "USD",
"total": 571.2,
"total_paid": 0,
"balance": 571.2
}
],
"next_cursor": null
},
"isError": false
}