List invoices
Invoices with client, status, dates, amount and balance, newest first.
MCP tool invoice_ninja_read → list_invoices
read
Lists invoices of one company, newest first. Status is one of draft, sent, partial, paid, cancelled or reversed, and several can be combined with commas. Set overdue to get only invoices past their due date or past the due date of their Partial/Deposit amount. days_overdue is counted from the due date to today. An invoice without a due date is due immediately. Pages hold up to 100 invoices; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| company string | string | Company name, for accounts with several companies. Default: the company open when you signed in. |
| status string | string | draft, sent, partial, paid, cancelled or reversed. Several allowed, comma separated. |
| overdue boolean | boolean | true returns only overdue invoices. |
| client_id string | string | Only invoices of this client. |
| date_from date | date | Only invoices dated on or after this day. |
| date_to date | date | Only invoices dated on or before this day. |
| limit integer | integer | 1 to 100. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "invoice_ninja_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_number": "INV-0038",
"client_id": "Bk92tLmq1x",
"client": "Brightwave Ltd",
"status": "sent",
"invoice_date": "2026-09-01",
"due_date": "2026-09-30",
"days_overdue": 14,
"amount": 1800,
"balance": 1800,
"currency": "USD"
},
{
"invoice_number": "INV-0036",
"client_id": "Wp3xq8Rnd5",
"client": "Northwind Studio",
"status": "sent",
"invoice_date": "2026-09-10",
"due_date": "2026-10-10",
"days_overdue": 4,
"amount": 1200,
"balance": 1200,
"currency": "USD"
}
],
"next_cursor": "eyJwYWdlIjoyfQ"
},
"isError": false
}