Driveosplatform catalogue

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.

FieldTypeRequiredDescription
page / pageSizeinteger—Pagination; at most 100 per page
activeboolean—Only activated vehicles (true) or only inactive ones (false)
json200 — vozila (skraćeno)
{
  "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.

FieldTypeRequiredDescription
page / pageSizeinteger—Pagination; at most 100 per page
activeboolean—Only active drivers
json200 — vozači (skraćeno)
{
  "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

  1. The ride enters dispatch with status REQUESTED.
  2. The server selects drivers by the company’s rules (zone, vehicle class, distance, rating, shift) and sends an offer.
  3. The driver app shows the offer; acceptance moves the status to ACCEPTED, a rejection or expiry sends the offer on.
  4. When a driver accepts, driver in the ride detail stops being null — that is the moment an integration can tell the passenger the vehicle plate.
Light themeDark theme
The same fleet in the company console: status, documents, rating and vehicle.