Skip to main content
GET
/
api
/
billing-accounts
/
{baId}
/
invoices
Get Billing Info Records for a Billing Account by invoice period
curl --request GET \
  --url https://fleet.staging.ezprk.dev/api/billing-accounts/{baId}/invoices \
  --header 'Authorization: Bearer <token>'
[
  {
    "infoId": 123,
    "infoRecordId": 123,
    "recordType": "<string>",
    "recordSubType": "<string>",
    "startDate": "2023-11-07T05:31:56Z",
    "endDate": "2023-11-07T05:31:56Z",
    "costCenter": "<string>",
    "currency": {
      "currencyCode": "<string>",
      "numericCode": 123,
      "numericCodeAsString": "<string>",
      "displayName": "<string>",
      "symbol": "<string>",
      "defaultFractionDigits": 123
    },
    "vat": 123,
    "amountExcludingVat": 123,
    "amountIncludingVat": 123,
    "parking": {
      "licensePlate": "<string>",
      "id": 123,
      "areaNumber": "<string>",
      "areaName": "<string>",
      "areaCity": "<string>",
      "subType": "<string>",
      "areaId": 123,
      "operatorName": "<string>",
      "operatorVatNumber": "<string>",
      "countryCode": "<string>",
      "note": "<string>",
      "currency": "<string>"
    },
    "user": {
      "id": 123,
      "firstName": "<string>",
      "lastName": "<string>",
      "phoneNumber": "<string>"
    }
  }
]

Authorizations

​
Authorization
string
header
required

You can get the JWT from the Login endpoint

Path Parameters

​
baId
integer<int64>
required

Billing account ID

Query Parameters

​
period
string
required

Filters billing info records (BIRs) by the invoice period — the calendar month in which the invoice was produced and issued (i.e. the invoice date), not the month the costs were incurred. For example, parking from May that is invoiced in June has invoice period '2026-06'.

Validation Constraints:

  • Format: YYYY-MM
  • Future periods relative to the current calendar month are not allowed and will immediately return a 400 Bad Request error (for example, requesting '2026-07' when the current calendar month is June). The current month is permitted once its invoices have been produced.

Data Availability & Retry Mechanism: The invoices of a given month become accessible only after that month's billing run successfully completes. In a standard scenario, the billrun finishes overnight between the 1st and the 2nd of the month, meaning finalized data is ready to be fetched on the morning of the 2nd. However, weekends or public holidays can delay this process by a few days depending on the specific invoicing provider (potentially pushing generation to the 4th or 5th). If you query the current invoice period before the billrun has finished, the API returns a 409 indicating the data is not yet available; clients must implement a retry mechanism to periodically poll the endpoint until the finalized data is released.

Response

Returns all Billing Info Records for the requested invoice period

​
infoId
integer<int64>
​
infoRecordId
integer<int64>
​
recordType
string
​
recordSubType
string
​
startDate
string<date-time>
​
endDate
string<date-time>
​
costCenter
string
​
currency
object
​
vat
number
​
amountExcludingVat
number
​
amountIncludingVat
number
​
parking
object
​
user
object