List invoices
Customer invoices with number, customer, dates, status and amounts.
MCP tool bokio_read → list_invoices
read
Lists invoices of the company, 25 per page by default and up to 100. Filter by status (draft, published, paid, overPaid, underPaid, overdue, credited, credit), by due date or by customer. Each item carries total, VAT and the amount paid so far, so unpaid invoices are the ones where paid_amount is below total.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | draft, published, paid, overPaid, underPaid, overdue, credited or credit. |
| due_before string | string | Only invoices due on or before this date, YYYY-MM-DD. |
| customer_id string | string | Customer ID from list_customers. |
| page integer | integer | Page number. Default: 1. |
| page_size integer | integer | 1 to 100. Default: 25. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bokio_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2",
"invoice_number": "2026-1042",
"customer": "Nordlys Design AB",
"status": "overdue",
"invoice_date": "2026-09-13",
"due_date": "2026-10-13",
"currency": "SEK",
"total_amount": 13125,
"total_tax": 2625,
"paid_amount": 0
}
],
"total_items": 1,
"total_pages": 1,
"current_page": 1
},
"isError": false
}