Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Aggregated Data APIs

There are several report types a user can consume data from. The Historical Data requests are asynchronous and are generated in the background. The output of the request depends on the type of data selected as the format varies.

The two types of historical data available:

Raw Data: data is displayed via a point by point view of a vehicle’s drive. Each row represents a single point, while each column represents an attribute from your bundle. The attributes are determined based on the bundle associated with your specific Workspace.

Trips: data is aggregated and displays a summarized view of an entire vehicle’s drive (trip). Each row represents a single trip, while each column represents an attribute. The attributes are determined based on the bundle associated with your specific Workspace.

Every report displays data based on the attributes and enrichments associated with your Workspace. Additionally, every report is based on the vehicle limit you’ve selected for your Workspace.

The type of historical data available to you and the exact content within each CSV depends on the data bundle associated with your Workspace.

The following table summarizes all available historical data APIs.


Request Type

Time Frame


Raw Data

Vehicle Data

Up to 1 month

Provides data points from all the vehicles associated with a specific Workspace.

Aggregated Trips Data

Aggregated Vehicle Data

Up to 1 month

Provides aggregated data on the various trips vehicles have driven.

Trip Points

Vehicle Data

Length of trip

Provides data points from a specific trip a vehicle has driven.

In order to ensure standardisation, the time zone used is the Coordinated Universal Time or UTC. If, for example, you are located in the Pacific Time Zone (GMT-8), you would add 8 hours to calculate the corresponding Coordinated Universal Time.

How many requests may be executed per day?
By default, you may execute up to a total of 10 requests for each application per day (UTC time).

To access the report, run the Report Status API. The output presented in the response body will be a downloadable link to a CSV file of up to 1 GB. If the data comprised in the report should be larger than 1 GB, a new CSV file will be generated.

What is the duration for which the report is downloadable?
Reports are available for download for 30 days.

Updated 5 months ago

Aggregated Data APIs

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.