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"
}