Drivers and vehicles
Who drives and in which vehicle: two read-only lists, because the fleet is edited in the console.
A dispatcher and a developer need the same answer to the same question: who is driving right now, and in which vehicle. The list is read-only; the fleet is edited in the console, where paperwork and checks live.
Vehicles
GET/api/v1/vehicles
The company’s vehicle list. Scope vehicles.
| Field | Type | Required | Description |
|---|---|---|---|
page / pageSize | integer | — | Pagination; at most 100 per page |
active | boolean | — | Only activated vehicles (true) or only inactive ones (false) |
{
"vehicles": [
{
"id": "2b7d1a4c-0f6e-4f8f-9d2a-6b3c1a5e7f21",
"plate": "ZG-1234-AB",
"model": "Škoda Octavia",
"color": "bijela",
"seatCount": 4,
"vehicleClass": { "code": "STANDARD", "name": "Standard" },
"isActive": true
}
],
"meta": { "page": 1, "pageSize": 25, "total": 12, "pages": 1, "hasMore": false }
}
Drivers
GET/api/v1/drivers
The company’s driver list. Scope drivers. Returns code, name, status and whether the driver is on duty.
| Field | Type | Required | Description |
|---|---|---|---|
page / pageSize | integer | — | Pagination; at most 100 per page |
active | boolean | — | Only active drivers |
{
"drivers": [
{
"id": "8c4f2b61-7a3d-4e5c-8b1f-2d6a9e0c3b47",
"code": "D-014",
"fullName": "Ivo Ivić",
"phone": "+385 91 555 0114",
"rating": 4.9,
"isActive": true,
"onDuty": true
}
],
"meta": { "page": 1, "pageSize": 25, "total": 7, "pages": 1, "hasMore": false }
}
Only what the integration needsThe response does not contain tax ids, ID numbers, documents, card data or rating history. If you need a field, that is a conversation about extending the contract — not an assumption that it exists.
How a ride gets a driver
- The ride enters dispatch with status
REQUESTED. - The server selects drivers by the company’s rules (zone, vehicle class, distance, rating, shift) and sends an offer.
- The driver app shows the offer; acceptance moves the status to
ACCEPTED, a rejection or expiry sends the offer on. - When a driver accepts,
driverin the ride detail stops beingnull— that is the moment an integration can tell the passenger the vehicle plate.

