get
/api/v2/origin-destination/open-matrix/{id}/time-series
Python SDK method:
client.origin_destination.open_matrix(id=job_id).time_series_results()

Get open OD matrix time-series results

Returns paginated time-series journey metric rows for a completed open-ended OD time-series child analysis. To generate time series, set generateTimeSeries parameter to true on the original analysis along with aggregationUnits.

Altitude Help Center — Open-Ended OD API

Input Parameters

NameLocationTypeValuesDescriptionValue Required
idpathstring-Unique resource identifier.Y
pageTokenquerystring-Pagination token returned in the Link header of a previous response. Omit to fetch the first page.N

Success Responses

200 response: object

Paginated result data. When more pages are available, a Link: rel="next" header and Altitude-* pagination headers are included in the response.

NameTypeDescription
aggregationDateRangesarray<object>Date ranges included in the aggregation.
aggregationUnitstringTime aggregation unit.
aggregationValuestringTime aggregation bucket value.
connectorCodestringRaw connector zone code.
connectorIdstringEncoded connector zone identifier for use in subsequent API requests.
connectorTypestringConnector zone type.
connector_iso_3166_2stringISO 3166-2 state/province code of the connector zone.
destinationCodestringRaw destination zone code (e.g. county FIPS, ZIP code, custom zone ID).
destinationIdstringEncoded destination zone identifier for use in subsequent API requests.
destinationNamestringDestination zone description.
destinationTypestringDestination zone type.
destination_iso_3166_2stringISO 3166-2 state/province code of the destination zone.
durationAtDestinationAvgnumber (double)Average duration at destination (minutes).
durationAtDestinationMednumber (double)Median duration at destination (minutes).
flowIdstringFlow identifier.
interTripStopDurationAvgnumber (double)Average inter-trip stop duration (minutes).
interTripStopDurationMednumber (double)Median inter-trip stop duration (minutes).
journeyCountinteger (int64)Observed journey count.
journeyCountByVehicleClassarray<object>Journey count by vehicle class.
journeyCountByVocationarray<object>Journey count by vocation.
journeyDistanceAvgnumber (double)Average journey distance (miles or kilometers, according to isMetric).
journeyDistanceMednumber (double)Median journey distance (miles or kilometers, according to isMetric).
journeyDurationAvgnumber (double)Average journey duration (minutes).
journeyDurationMednumber (double)Median journey duration (minutes).
originCodestringRaw origin zone code (e.g. county FIPS, ZIP code, custom zone ID).
originIdstringEncoded origin zone identifier for use in subsequent API requests.
originNamestringOrigin zone description.
originTypestringOrigin zone type.
origin_iso_3166_2stringISO 3166-2 state/province code of the origin zone.
zoneFlowTypestringOpen-ended flow type.

Response Errors

HTTP Status CodeReason
400The request body or parameters are invalid.
401Authentication is required or the provided credentials are invalid.
403The authenticated user lacks permission to perform this operation.
404The requested resource does not exist.
409Result not yet ready. Poll the status monitor.
429The request rate limit has been exceeded.
500An unexpected server error occurred.