List invoices
Customer invoices with number, customer, dates, status and amounts.
GET https://cotlet.dev/api/v1/bokio/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. |
Request
curl https://cotlet.dev/api/v1/bokio/invoices \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bokio", "list_invoices")const result = await cotlet.call('bokio', 'list_invoices');cotlet call bokio list_invoicesExample response
{
"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
}