Skip to main content

Migration v1 → v2

legacy

For partners migrating from the v1 API. If you're building a new integration, skip this page.

Authentication: bearer token removed

v1 required POST /authentication to obtain a JWT bearer token, then passing Authorization: Beareron every call, with refresh logic. v2 replaces all of that with two static headers.

Endpoint URL changes

v1v2
POST /authenticationRemoved
GET /v1/company-infoGET /v2/company-info
GET /v1/driversGET /v2/drivers
GET /v1/driver/{driverId}GET /v2/driver/{driver_id}
GET /v1/latest_driver_statusGET /v2/latest-driver-status
GET /v1/vehiclesGET /v2/vehicles
GET /v1/vehicle/{vehicleId}GET /v2/vehicle/{vehicle_id}
GET /v1/latest_vehicle_statusGET /v2/latest-vehicle-status
— (not available)GET /v2/vehicle-location-history/{vehicle_id}

Field renames

camelCase → snake_case across every parameter and response field.

v1v2
companyIdcompany_id
driverIddriver_id
vehicleIdvehicle_id
firstNamefirst_name
currentStatuscurrent_status
VINvin

Pagination & IDs

v1 used skip + limit. v2 uses page (1-indexed) +limit. Responses now includepage, size,total_elements,total_pages.

All entity IDs migrated to UUID. Old-format IDs are still accepted in path parameters but responses always return UUID. To remap stored IDs, match by username (drivers) orvin (vehicles).

esc