SmartGare
API referenceEndpoints

Search permits approaching or past expiry

Returns a cross-fleet worklist in station time, including the expiry watch's durable announcement history.

GET/referential/v1/vehicle-permits/expiring

Returns a cross-fleet worklist in station time, including the expiry watch's durable announcement history.

AuthorizationBearer <token>

In: header

Query Parameters

search?string

Matches part of a permit number or vehicle plate.

Defaultnull
state?string

Restrict to permits approaching expiry or already expired.

Defaultnull

Value in

  • "ALL"
  • "EXPIRING"
  • "EXPIRED"
horizonDays?integer

Future window in days, from station today.

Formatint32
Range1 <= value <= 365
Defaultnull
page?integer

Zero-based page index.

Formatint32
Range0 <= value
Defaultnull
size?integer

Page size, at most 200.

Formatint32
Range0 <= value <= 200
Defaultnull

Response Body

*/*

curl -X GET "https://example.com/referential/v1/vehicle-permits/expiring"
{  "data": [    {      "id": "string",      "vehicleId": "string",      "plateNumber": "string",      "number": "string",      "validFrom": "2019-08-24",      "validUntil": "2019-08-24",      "source": "string",      "daysRemaining": 0,      "announcements": [        {          "permitId": "string",          "kind": "string",          "horizonDays": 0,          "announcedOn": "2019-08-24",          "createdAt": "2019-08-24T14:15:22Z"        }      ]    }  ],  "page": 0,  "size": 0,  "total": 0}