Analysis Preview

Service version: 1 Last edit: 2026.04.22

Important Note
Explore ready-to-use traffic reports and data visualizations immediately by signing up for a 30-day free trial on the MOVE Portal. Once registered, you’ll receive an API key to start using the Traffic Analytics APIs right away. Alternatively, you may contact our Sales team for a tailored solution.

Purpose

Get a preview of the analysis by sending a GET request.

Request data

HTTPS Method: `GET`

For ease of viewing and identification:

Constants and parameters enclosed in curly brackets { } must be replaced with their values.
Please see the following Request parameters section with the required and optional parameters tables for their values. The generic request format is as follows.

Format

get

URL request format

1
https://{baseURL}/origindestination/{versionNumber}/analysis/flowmatrix/{id}?key={Your_API_Key}

Example

get

URL request example

1
https://api.tomtom.com/origindestination/1/analysis/flowmatrix/512?key={Your_API_Key}

Request parameters

Required parameters	Description
`baseURL` string	The base URL for calling TomTom services. Value: `api.tomtom.com`
`versionNumber` string	Version of the service to call. Value: The current value is `1`.
`id` integer	Analysis number id. Value: The analysis number id.
`key` string	Authorization key for access to the API. Value: Your valid API Key.

Response data

Response structure

Field	Description
`analysisInfo` string	Information about the analysis.
`analysisInfo.id` integer	Analysis number id.
`analysisInfo.name` string	Job name, given for the user’s convenience.
`analysisInfo.owner` string	Email of the analysis’ owner.
`analysisInfo.status` string	Job status . One of the following values: `WAITING` `RUNNING` `ENDED` `FAILED` `CANCELLED` `ACCEPTED` `REJECTED`
`analysisInfo.currentProgress` integer	Current value of the job progress (0-100).
`analysisInfo.creationTime` datetime	Job creation time in `YYYY-MM-DDTHH:mm:ss.SSSZ` format.
`analysisInfo.timeDefinition` time	Time definition of the analysis.
`analysisInfo.tripsCounted` integer	How many trips were counted. Updates when the analysis is in progress.
`analysisInfo.startAnalysisTime` datetime	Date and time start of the analysis in the format: `YYYY-MM-DDTHH:mm:ss.SSSZ`.
`analysisInfo.endAnalysisTime` datetime	Date and time end of the analysis in the format: `YYYY-MM-DDTHH:mm:ss.SSSZ`.
`analysisInfo.estimatedDuration` integer	Estimated time in seconds to change the analysis status from `RUNNING` to `ENDED`.
`analysisInfo.type` string	Type of the created analysis.
`analysisInfo.mapType` string	Map type used during the analysis . Supported types are: `ORBIS` and `GENESIS`.
`regionsLink` string	URL to the regions defined in the analysis. Your API Key needs to be added to the URL.
`results` array	List of the results available only when the analysis has a status of `ACCEPTED`.
`aggregatedHistogramStats` object	Object containing links to aggregated histogram statistics CSV files. Only present when `aggregatedTripStats` was enabled during analysis creation . Links are valid for 3 hours from the time of retrieval; each new request to the preview endpoint generates fresh links. See Aggregated Histogram Statistics for details on the CSV format.
`aggregatedHistogramStats.durationsLink` string	URL to download the aggregated durations histogram CSV file.
`aggregatedHistogramStats.lengthsLink` string	URL to download the aggregated lengths histogram CSV file.
`aggregatedHistogramStats.avgSpeedsLink` string	URL to download the aggregated average speeds histogram CSV file.

Response example

Response body - JSON

1
{
2
  "analysisInfo": {
3
    "id": "4521660963097771615",
4
    "name": "Example analysis",
5
    "type": "FLOW_MATRIX",
6
    "owner": "user@example.com",
7
    "developerId": "user@example.com",
8
    "status": "ACCEPTED",
9
    "creationTime": "2026-04-22T11:49Z",
10
    "startAnalysisTime": "2026-04-22T11:49Z",
11
    "endAnalysisTime": "2026-04-22T11:55Z",
12
    "tripsCounted": "1902537",
13
    "timeDefinition": {
14
      "dateRanges": [
15
        {
16
          "startDate": "2026-04-06",
17
          "endDate": "2026-04-12",
18
          "exclusions": [],
19
          "daysOfWeek": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"]
20
        }
21
      ],
22
      "timeRanges": [
23
        {
24
          "startTime": "00:00",
25
          "endTime": "00:00"
26
        }
27
      ],
28
      "zoneId": "Europe/Warsaw",
29
      "daysOfWeek": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"],
30
      "timeRangeCondition": "WHOLE"
31
    },
32
    "tripStats": true,
33
    "aggregatedTripStats": true,
34
    "dataSources": "ALL",
35
    "passMatrix": true,
36
    "map": {
37
      "type": "OPEN_DSEG",
38
      "version": "2026.04.0900"
39
    },
40
    "mapMatchOption": "AUTO",
41
    "isMapMatched": true,
42
    "mapType": "ORBIS"
43
  },
44
  "regionsLink": "https://api.tomtom.com/origindestination/rest/analysis/4521660963097771615/regions?version=...",
45
  "results": [
46
    {
47
      "dateRange": {
48
        "startDate": "2026-04-06",
49
        "endDate": "2026-04-12",
50
        "exclusions": [],
51
        "daysOfWeek": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"]
52
      },
53
      "timeRange": {
54
        "startTime": "00:00",
55
        "endTime": "00:00"
56
      },
57
      "tripsResultFileSize": 1.63e-4,
58
      "tripsWholeResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/trips?dateRange=0&timeRange=0",
59
      "tripsPartialResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/partial/trips?dateRange=0&timeRange=0",
60
      "hoursOfDayHistogramPartialResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/partial/histogram?dateRange=0&timeRange=0&type=HOURS_OF_DAY",
61
      "lengthsHistogramPartialResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/partial/histogram?dateRange=0&timeRange=0&type=LENGTHS",
62
      "durationsHistogramPartialResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/partial/histogram?dateRange=0&timeRange=0&type=DURATIONS",
63
      "avgSpeedsHistogramPartialResultLink": "https://api.tomtom.com/origindestination/rest/analysis/flowmatrix/.../result/partial/histogram?dateRange=0&timeRange=0&type=AVG_SPEEDS"
64
    }
65
  ],
66
  "aggregatedHistogramStats": {
67
    "durationsLink": "{durationsLink}",
68
    "lengthsLink": "{lengthsLink}",
69
    "avgSpeedsLink": "{avgSpeedsLink}"
70
  }
71
}

Response link structure

Field	Description
`tripsWholeResultLink` string	URL to the whole analysis trips result .
`tripsPartialResultLink` string	URL to the partial analysis trips result. Your API Key needs to be added to the URL.
`durationsHistogramPartialResultLink` string	URL to the partial analysis trips duration histogram result. Your API Key needs to be added to the URL.
`lengthsHistogramPartialResultLink` string	URL to the partial analysis trips lengths histogram result. Your API Key needs to be added to the URL.
`hoursOfDayHistogramPartialResultLink` string	URL to the partial analysis trips start hour of day histogram result. Your API Key needs to be added to the URL.
`avgSpeedsHistogramPartialResultLink` string	URL to the partial analysis trips average speeds histogram result. Your API Key needs to be added to the URL.
`tripsResultFileSize` integer	Trips result file size in megabytes. It will help you decide if you want to download the whole or a partial result.
`dateRange` dateRange	Date range of the result.
`dateRange.startDate` date	Start date of the date range in `YYYY-MM-DD` format.
`dateRange.endDate` dateRange	End date of the date range in `YYYY-MM-DD` format.
`dateRange.exclusions` array	List of dates to exclude from the given range in `YYYY-MM-DD` format.
`dateRange` time	Time range of the result.
`timeRange.startTime` time	Start time of the time range in `HH:mm` format.
`timeRange.endTime` time	End time of the time range in `HH:mm` format.

Trips response structure

Field	Description
`links` array	Array of links between regions.

Response interpretation example