Trips Data

post

https://api.otonomo.io/v1/aggregate/reports/AnonymousHistoricalTripsData

Fetches aggregated data from Trips data set on the various trips vehicles have driven.
The report includes any trip that has a start time and end time within the configured period.

The report includes any trip that has started at, ended at or passed through the selected geography (Country, State, City, or Polygon).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
Trips Geo Route usage
The "metadata_reason_for_selection_geographic_filter" attribute is added to the generated report by default

📘
Read about API Rate Limits

📘
Read more about Error Codes.

Body Params

start_datetime

date

required

The start date and time of the report (YYYY-MM-DD HH:MM:SS)

end_datetime

date

required

The end date and time of the report (YYYY-MM-DD HH:MM:SS)

country_codes

array of strings

required

Comma separated strings of 2-or-3 lettered country codes.

country_codes*

states

array of strings

Comma separated strings of state names. The country_codes filter is required when using this parameter. The report includes any trip that either started or ended on one or more of listed states.

states

cities

array of strings

Comma separated strings of city names. The country_codes filter is required when using this parameter. The report includes any trip that started, ended, or passed through on one or more of the listed cities.

cities

polygon

array of strings

We support 2 formats: 1. WKT Format 2. A list of lists comprised of dictionaries representing each point (lon, lat) in a polygon. The country_codes filter is required when using this parameter. The report includes any trip that has either started or ended on the polygon.

polygon

cars_limit

int32

The maximum number of cars the report should return.

records_limit

int32

The maximum number of trips records allowed per report

start_at

boolean

Defaults to true

When set as 'true', the generated report will include Trips that have started at the selected geography (Country, State, City, Polygon)

pass_through

boolean

Defaults to true

When set as 'true', the generated report will include Trips that have passed through the selected geography (Country, State, City, Polygon)

end_at

boolean

Defaults to true

When set as 'true', the generated report will include Trips that have ended at the selected geography (Country, State, City, Polygon)

Responses

🚧Trips Geo Route usage

📘

📘

200200

404404

🚧
Trips Geo Route usage