Skip to main content
GET
/
invoices
List MijnKlantportaal invoices
curl --request GET \
  --url https://api.mijnklantportaal.nl/v1/invoices \
  --header 'Authorization: Bearer <token>'
{
  "current_page": 1,
  "data": [
    {
      "id": "fac_abc12345def678",
      "invoiceNumber": "MKP-2025.0010",
      "lines": [
        {
          "id": "fcl_abc12345def678",
          "description": "Pro subscription",
          "quantity": 1,
          "currency": "EUR",
          "amountExclVat": 12.95,
          "vatRate": 21,
          "vatAmount": 2.72,
          "amountInclVat": 15.67
        }
      ],
      "currency": "EUR",
      "subtotalAmount": 12.95,
      "vatAmount": 2.72,
      "totalAmount": 15.67,
      "issuedAt": "2025-04-12T00:00:00.000Z",
      "isPaid": true
    }
  ],
  "first_page_url": "https://api.mijnklantportaal.nl/v1/invoices?page=1",
  "from": 1,
  "next_page_url": "https://api.mijnklantportaal.nl/v1/invoices?page=2,",
  "path": "https://api.mijnklantportaal.nl/v1/invoices",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Paginated response with invoices

​
current_page
integer

Current page of the response

Example:

1

​
data
object[]

Array of Invoice objects

​
first_page_url
string

Endpoint to go to the first page of objects

Example:

"https://api.mijnklantportaal.nl/v1/invoices?page=1"

​
from
integer

Offset of the current page

Example:

1

​
next_page_url
string | null

Endpoint to get the next batch of objects, if available

Example:

"https://api.mijnklantportaal.nl/v1/invoices?page=2,"

​
path
string

Current used endpoint

Example:

"https://api.mijnklantportaal.nl/v1/invoices"

​
per_page
integer

Amount of object returned per page. Default is 15 objects

Example:

15

​
prev_page_url
string | null

Endpoint to get the previous batch of object, if available

Example:

null

​
to
integer

Next offset of objects

Example:

15