List matching jobs
Purpose
Retrieve a list of all matching jobs in your account, including their statuses and metadata.
Request data
HTTP method: GET
- Constants and parameters enclosed in curly brackets
{}must be replaced with their values. - See the following Request parameters section with the required and optional parameters tables for these values.
URL format
get
URL format
https://api.tomtom.com/maps/orbis/platform/gem/jobs
URL example
get
URL example
https://api.tomtom.com/maps/orbis/platform/gem/jobs
curl command example
get
curl command example
1curl -X GET "https://api.tomtom.com/maps/orbis/platform/gem/jobs" \2 -H "tomtom-api-key: YOUR_API_KEY" \3 -H "Authorization: Bearer YOUR_AUTH_TOKEN" \4 -H "X-Version: 1"
Request headers
| Header | Required | Description |
|---|---|---|
tomtom-api-key | Yes | Your TomTom API key |
Authorization | Yes | Bearer token from Azure CLI |
X-Version | Yes | API version (use 1) |
Response data
Response example
1{2 "jobs": [3 {4 "jobRunId": "job-abc123",5 "storageId": "storage-001",6 "inputFileName": "roads_data.parquet",7 "outputFileName": "roads_data_matched.parquet",8 "matchingType": "road",9 "overtureRelease": "<latest-overture-release>",10 "status": "finished",11 "createdAt": "2026-01-20T10:00:00Z",12 "modifiedAt": "2026-01-20T10:15:00Z"13 },14 {15 "jobRunId": "job-def456",16 "storageId": "storage-001",17 "inputFileName": "places_data.parquet",18 "matchingType": "road",19 "overtureRelease": "<latest-overture-release>",20 "status": "running",21 "createdAt": "2026-01-21T14:30:00Z",22 "modifiedAt": "2026-01-21T14:30:00Z"23 }24 ]25}
Response fields
| Field | Type | Description |
|---|---|---|
jobs | array | List of job objects |
jobs[].jobRunId | string | Unique identifier for the job |
jobs[].storageId | string | Storage where files are located |
jobs[].inputFileName | string | Name of the input file |
jobs[].outputFileName | string | Name of output file (when available) |
jobs[].matchingType | string | Type of matching performed |
jobs[].overtureRelease | string | Overture Maps release version used |
jobs[].status | string | Current job status |
jobs[].createdAt | string | ISO 8601 timestamp of job creation |
jobs[].modifiedAt | string | ISO 8601 timestamp of last update |
Job status values
| Status | Description |
|---|---|
queued | Job is waiting to be processed |
running | Job is currently being executed |
finished | Job completed successfully |
failed | Job encountered an error |
cancelled | Job was cancelled by user |
Error responses
| HTTP Status | Error | Cause | Solution |
|---|---|---|---|
| 401 | Unauthorized | Invalid credentials | Refresh API key or token |
| 403 | Forbidden | Insufficient permissions | Check your access rights |
| 500 | Internal Server Error | Server-side issue | Retry the request |