Drivers API
Manage and retrieve driver information for your fleet.
List Drivers
Retrieve a paginated list of drivers.
GET /api/drivers
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number (default: 1) |
| limit | integer | No | Items per page (default: 10) |
| search | string | No | Search by name or email |
| status | string | No | Filter by status: active, inactive |
Response
{
"count": 45,
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"phone": "+1234567890",
"license_number": "D1234567",
"license_state_id": "CA",
"status": "active",
"company_id": "...",
"created_at": "2025-01-15T10:30:00Z",
"updated_at": "2025-06-20T14:22:00Z"
}
]
}
Example
curl -X GET "https://api-gateway.motioneld.com/api/drivers?status=active&limit=25" \
-H "X-API-Key: YOUR_API_KEY"
Get Driver
Retrieve a specific driver by ID.
GET /api/drivers/{driver_id}
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| driver_id | string (UUID) | The driver's unique identifier |
Response
Returns a single driver object (same structure as list item).
Example
curl -X GET "https://api-gateway.motioneld.com/api/drivers/550e8400-e29b-41d4-a716-446655440000" \
-H "X-API-Key: YOUR_API_KEY"