Skip to main content
GET
/
v1
/
organizations
/
{orgId}
/
trips
/
active
curl "https://api.bookovia.com/v1/organizations/org_123456/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": "user_789012",
        "status": "paused",
        "purpose": "commute",
        "start_time": "2026-04-17T09:15:00Z",
        "duration_seconds": 2400,
        "distance_meters": 18300,
        "created_at": "2026-04-17T09:15:00Z"
      },
      {
        "id": "c3d4e5f6-g7h8-9012-cdef-g34567890123",
        "org_id": "org_123456",
        "vehicle_id": "33445566-7788-99aa-bbcc-ddeeff223344",
        "user_id": "user_345678",
        "status": "recording",
        "purpose": "personal",
        "start_time": "2026-04-17T08:45:00Z",
        "duration_seconds": 5100,
        "distance_meters": 35200,
        "created_at": "2026-04-17T08:45:00Z"
      }
    ],
    "count": 3
  }
}

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 across an organization. Returns trips with status recording or paused for all vehicles and users, ordered by start time (newest first).

​
Path Parameters

​
orgId
string
required
The unique identifier for the organization 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/organizations/org_123456/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": "user_789012",
        "status": "paused",
        "purpose": "commute",
        "start_time": "2026-04-17T09:15:00Z",
        "duration_seconds": 2400,
        "distance_meters": 18300,
        "created_at": "2026-04-17T09:15:00Z"
      },
      {
        "id": "c3d4e5f6-g7h8-9012-cdef-g34567890123",
        "org_id": "org_123456",
        "vehicle_id": "33445566-7788-99aa-bbcc-ddeeff223344",
        "user_id": "user_345678",
        "status": "recording",
        "purpose": "personal",
        "start_time": "2026-04-17T08:45:00Z",
        "duration_seconds": 5100,
        "distance_meters": 35200,
        "created_at": "2026-04-17T08:45:00Z"
      }
    ],
    "count": 3
  }
}

​
Use Cases

  • Fleet Dashboard: Real-time overview of all active vehicles and drivers
  • Operations Monitoring: Track fleet utilization and availability
  • Dispatch Management: See which vehicles/drivers are currently busy
  • Safety Monitoring: Identify long-running trips that may need attention
  • Resource Planning: Understand current fleet capacity

​
Important Notes

  • Returns trips with status recording or paused across entire organization
  • Results are ordered by start_time DESC (newest first)
  • Empty array returned if organization has no active trips
  • Requires valid API key with bkv_ prefix
  • No pagination limit - returns all active trips

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