Skip to main content
GET
/
v1
/
users
/
{userId}
/
trips
/
active
curl "https://api.bookovia.com/v1/users/86927352-9739-4317-980c-59dfbb6059eb/trips/active" \
  -H "X-API-Key: bkv_test_your_api_key"
{
  "success": true,
  "data": {
    "trips": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "org_id": "org_123456",
        "vehicle_id": "16128b9d-5356-48a8-b9e0-be1a9b904c6f",
        "user_id": "86927352-9739-4317-980c-59dfbb6059eb",
        "status": "recording",
        "purpose": "business",
        "start_time": "2026-04-17T10:30:00Z",
        "duration_seconds": 3600,
        "distance_meters": 42700,
        "created_at": "2026-04-17T10:30:00Z"
      },
      {
        "id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
        "org_id": "org_123456",
        "vehicle_id": "22334455-6677-8899-aabb-ccddee001122",
        "user_id": "86927352-9739-4317-980c-59dfbb6059eb",
        "status": "paused",
        "purpose": "personal",
        "start_time": "2026-04-17T09:15:00Z",
        "duration_seconds": 2400,
        "distance_meters": 18300,
        "created_at": "2026-04-17T09:15:00Z"
      }
    ],
    "count": 2
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.bookovia.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Fetches all active (recording or paused) trips for a specific user. Returns trips with status recording or paused, ordered by start time (newest first).

Path Parameters

userId
string
required
The unique identifier for the user whose active trips you want to retrieve

Headers

X-API-Key
string
required
Your API key for authentication starting with bkv_

Response

success
boolean
Indicates if the request was successful
data
object
Response data object
curl "https://api.bookovia.com/v1/users/86927352-9739-4317-980c-59dfbb6059eb/trips/active" \
  -H "X-API-Key: bkv_test_your_api_key"
{
  "success": true,
  "data": {
    "trips": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "org_id": "org_123456",
        "vehicle_id": "16128b9d-5356-48a8-b9e0-be1a9b904c6f",
        "user_id": "86927352-9739-4317-980c-59dfbb6059eb",
        "status": "recording",
        "purpose": "business",
        "start_time": "2026-04-17T10:30:00Z",
        "duration_seconds": 3600,
        "distance_meters": 42700,
        "created_at": "2026-04-17T10:30:00Z"
      },
      {
        "id": "b2c3d4e5-f6g7-8901-bcde-f23456789012",
        "org_id": "org_123456",
        "vehicle_id": "22334455-6677-8899-aabb-ccddee001122",
        "user_id": "86927352-9739-4317-980c-59dfbb6059eb",
        "status": "paused",
        "purpose": "personal",
        "start_time": "2026-04-17T09:15:00Z",
        "duration_seconds": 2400,
        "distance_meters": 18300,
        "created_at": "2026-04-17T09:15:00Z"
      }
    ],
    "count": 2
  }
}

Use Cases

  • Driver Monitoring: Track which trips a specific driver has in progress
  • Multi-Vehicle Users: See all active trips for users with multiple vehicles
  • Activity Dashboard: Display current driver activity and status
  • Trip Management: Identify paused or ongoing trips requiring attention

Important Notes

  • Returns trips with status recording or paused
  • Results are ordered by start_time DESC (newest first)
  • Empty array returned if user has no active trips
  • Requires valid API key with bkv_ prefix

Error Responses

401 Unauthorized
{
  "success": false,
  "error": "API key required"
}
401 Invalid API Key
{
  "success": false,
  "error": "Invalid API key format"
}
500 Server Error
{
  "success": false,
  "error": "Failed to fetch active trips"
}