Skip to main content
GET
/
v1
/
trips
/
{sessionId}
/
export
# Export complete trip data as JSON
curl "https://api.bookovia.com/v1/trips/a1b2c3d4-e5f6-7890/export?format=json&include=all" \
  -H "X-API-Key: bkv_live_0ef660a982f34f1fcb6a68d29c2d911379d3abf6b36282d9de77dd94c3391e74"

{
  "export_id": "exp_7f8e9d10-a1b2-4c5d-8e9f-0123456789ab",
  "trip_id": "a1b2c3d4-e5f6-7890",
  "format": "json",
  "file_size": 245760,
  "download_url": "https://storage.bookovia.com/exports/exp_7f8e9d10-a1b2-4c5d-8e9f-0123456789ab.json?expires=1713141600",
  "generated_at": "2026-04-14T21:15:30Z",
  "expires_at": "2026-04-15T21:15:30Z",
  "metadata": {
    "records_count": 1847,
    "events_count": 23,
    "duration_seconds": 3420,
    "distance_km": 47.2,
    "data_types": ["route", "analytics", "events", "safety"]
  }
}

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

Exports complete trip data including route information, analytics, events, and telemetry in multiple formats (JSON, CSV, GPX). Perfect for detailed analysis, compliance reporting, or integration with external systems.

​
Path Parameters

​
sessionId
string
required
The unique identifier for the trip session to export. This is the trip ID returned from the Start Trip endpoint.

​
Query Parameters

​
format
string
default:"json"
Export format. Options: json, csv, gpx, kml
​
include
string
Comma-separated data types to include. Options: route, analytics, events, telemetry, safety, all Default: route,analytics,events
​
time_zone
string
default:"UTC"
Timezone for timestamps. Example: Europe/London, America/New_York
​
compression
boolean
default:"false"
Whether to compress the export file (gzip)

​
Headers

​
X-API-Key
string
required
Your API key for authentication. Use your production key starting with bkv_live_

​
Response

​
export_id
string
Unique identifier for this export request
​
trip_id
string
The trip ID that was exported
​
format
string
Export format used
​
file_size
number
Size of exported file in bytes
​
download_url
string
Pre-signed URL to download the exported file (expires in 24 hours)
​
generated_at
string
ISO 8601 timestamp when export was generated
​
expires_at
string
ISO 8601 timestamp when download URL expires
​
metadata
object
Export metadata and statistics
# Export complete trip data as JSON
curl "https://api.bookovia.com/v1/trips/a1b2c3d4-e5f6-7890/export?format=json&include=all" \
  -H "X-API-Key: bkv_live_0ef660a982f34f1fcb6a68d29c2d911379d3abf6b36282d9de77dd94c3391e74"

{
  "export_id": "exp_7f8e9d10-a1b2-4c5d-8e9f-0123456789ab",
  "trip_id": "a1b2c3d4-e5f6-7890",
  "format": "json",
  "file_size": 245760,
  "download_url": "https://storage.bookovia.com/exports/exp_7f8e9d10-a1b2-4c5d-8e9f-0123456789ab.json?expires=1713141600",
  "generated_at": "2026-04-14T21:15:30Z",
  "expires_at": "2026-04-15T21:15:30Z",
  "metadata": {
    "records_count": 1847,
    "events_count": 23,
    "duration_seconds": 3420,
    "distance_km": 47.2,
    "data_types": ["route", "analytics", "events", "safety"]
  }
}

​
Export Formats

​
JSON Format

  • Use Case: API integration, detailed analysis
  • Contains: Complete structured data with nested objects
  • Size: Largest file size, most comprehensive

​
CSV Format

  • Use Case: Spreadsheet analysis, reporting dashboards
  • Contains: Flattened data in tabular format
  • Size: Medium file size, easy to import

​
GPX Format

  • Use Case: GPS device import, mapping software
  • Contains: Route waypoints with timestamps
  • Size: Smallest file size, location-focused

​
KML Format

  • Use Case: Google Earth, mapping applications
  • Contains: Route visualization with metadata
  • Size: Small file size, visualization-focused

​
Data Types Available

  • GPS coordinates with timestamps
  • Speed and heading at each point
  • Address information for waypoints
  • Route optimization suggestions
  • Trip summary statistics
  • Fuel consumption estimates
  • Performance metrics
  • ETA predictions and accuracy
  • Harsh braking/acceleration events
  • Speed limit violations
  • Pause/resume timestamps
  • Custom event markers
  • Driver behavior scoring
  • Risk assessments
  • Crash detection events
  • Safety recommendations
  • Raw sensor data
  • Vehicle diagnostics
  • Engine parameters
  • Environmental conditions

​
Use Cases

  • Compliance Reporting: Generate regulatory reports with detailed trip logs
  • Fleet Analysis: Export data for business intelligence and optimization
  • Insurance Claims: Provide comprehensive trip evidence for claims processing
  • Route Optimization: Analyze historical routes for efficiency improvements
  • Driver Training: Export behavior data for coaching and training programs

​
Important Notes

  • Export files are stored securely and auto-deleted after 7 days
  • Download URLs expire after 24 hours for security
  • Large exports (>100MB) are automatically compressed
  • Maximum export size is 500MB per request
  • Historical exports can be accessed via the Export History API