Skip to main content
GET
cURL
A vehicle’s active flag tells you where it stands today. This endpoint tells you where it stood at any past moment, which is what you need when deciding whether a toll happened while the vehicle was still on your fleet. Vehicles do get deactivated and brought back, so the current flag can’t answer that on its own. Each entry is one revision: when it changed, whether the vehicle was on your fleet at that point, and who made the change. Entries cover every recorded change to a vehicle, not only the ones that moved it on or off the fleet, so consecutive entries can carry the same active value.

Status at a point in time

Ask for the newest revision at or before the moment you care about, then read its active value:
An empty result means nothing was recorded before that moment, so the vehicle’s history starts later.
History starts on 3 June 2023, when revision tracking was added. Vehicles deactivated before then have no entries, and a lookup for an earlier moment comes back empty rather than reporting a value.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
integer
required

A unique integer value identifying this vehicle.

Query Parameters

active
boolean

Keep only revisions where the vehicle was (in)active.

history_date__gte
string<date-time>

Only revisions recorded at or after this moment.

history_date__lte
string<date-time>

Only revisions recorded at or before this moment.

history_type
enum<string>[]

Created, changed or deleted.

Available options:
+,
-,
~
limit
integer

Number of results to return per page.

offset
integer

The initial index from which to return the results.

status_with_toll_authority
enum<string>[]
Available options:
EXIST,
PENDING,
REMOVED,
REQUESTED_REMOVAL

Response

200 - application/json
count
integer
required
Example:

123

results
object[]
required
next
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=400&limit=100"

previous
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=200&limit=100"