Get Tasks

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

The Get Tasks endpoint retrieves the tasks with current statuses. This allows you to monitor the progress of tasks related to generating raw data archives for junctions.

Request data

You can retrieve tasks statuses by sending a GET request.

HTTPS method: GET

https://api.tomtom.com/junction-analytics/v1/archive/raw-data/tasks?key={Your_API_Key}&page={page}&size={size}&status={status}&from={fromDate}&to={toDate}

Request parameters

The following table shows the query parameters:

• Required parameters must be used or the call will fail.
• Optional parameters may be used.

Request headers

Example request

$ curl 'https://api.tomtom.com/junction-analytics/v1/archive/raw-data/tasks?key={Your_API_Key}&status=IN_PROGRESS&page=0&size=20&from=2024-08-01&to=2025-08-01' -i -X GET

Response data

This response returns a list of statuses for raw archive generation tasks.

Response body example

1{
2  "content": [
3    {
4      "id": "65268ff77cd5d952a185b9b7",
5      "status": "IN_PROGRESS",
6      "junctionIds": ["65268ff77cd5d952a185b9b5", "65268ff77cd5d952a185b9b6"],
7      "lastUpdatedAt": "2025-08-06T18:30:01.208Z"
8    },
9    {
10      "id": "65268ff77cd5d952a185b9b8",
11      "status": "COMPLETED",
12      "junctionIds": ["65268ff77cd5d952a185b9b9"],
13      "lastUpdatedAt": "2025-08-06T18:30:01.208Z"
14    }
15  ],
16  "pageable": {
17      "pageNumber": 0,
18      "pageSize": 2,
19      "sort": {
20          "empty": false,
21          "unsorted": false,
22          "sorted": true
23      },
24      "offset": 0,
25      "unpaged": false,
26      "paged": true
27  },
28  "last": true,
29  "totalElements": 2,
30  "totalPages": 1,
31  "first": true,
32  "size": 2,
33  "number": 0,
34  "sort": {
35      "empty": false,
36      "unsorted": false,
37      "sorted": true
38  },
39  "numberOfElements": 2,
40  "empty": false
41}

Response fields

Errors

The following table shows the HTTP error response codes.

Error response field

Example error response

1{
2  "errorMessage": "The end date 2025-08-24 of the time period should be before or equal to today."
3}