Skip to content
Basenet
🇳🇱 Nederlands
🇳🇱 Nederlands🇬🇧 English
Esc
↑↓navigate↵open⌘Jpreview

List invoices (scope billing:read)

GET/api/v1/invoices
Authorization
AuthorizationBearer token · headerrequired

Scoped API token (bnx_…). Required scopes are noted per operation.

Query parameters
$topinteger

Page size ($top, max 200).

min 1 · max 200
$skipinteger

Offset ($skip).

min 0
Responses
200

Paginated list

itemsobject[]required
Show properties
Array of object
idstringrequired
numberstring | nullrequired
matterIdstring | nullrequired
debtorRelationIdstring | nullrequired
departmentIdstring | nullrequired
statestringrequired
issueDatestring | nullrequired
dueDatestring | nullrequired
currencystringrequired
netCentsintegerrequired
vatCentsintegerrequired
grossCentsintegerrequired
paymentStatusstring | nullrequired
createdAtstringrequired
updatedAtstringrequired
totalintegerrequired
skipintegerrequired
topintegerrequired
401

Unauthenticated

errorstringrequired
codestringrequired
rulestring
403

Forbidden (missing scope or permission)

errorstringrequired
codestringrequired
rulestring
429

Rate limited

errorstringrequired
codestringrequired
rulestring
Request
curl -X GET '/api/v1/invoices' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "items": [
    {
      "id": "string",
      "number": "string",
      "matterId": "string",
      "debtorRelationId": "string",
      "departmentId": "string",
      "state": "string",
      "issueDate": "string",
      "dueDate": "string",
      "currency": "string",
      "netCents": 0,
      "vatCents": 0,
      "grossCents": 0,
      "paymentStatus": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 0,
  "skip": 0,
  "top": 0
}