Asynchronous Batch Download
Service version: 1
Last edit: 2019.11.29
On this page
Purpose
The Asynchronous Batch Download endpoint fetches results of the asynchronous batch processing.
- It responds with HTTP
200
and the batch results assuming batch processing has completed, or HTTP202
"Accepted" if the batch is still being processed. - HTTP
202
"Accepted" will be sent after 120 seconds by default. This behavior can be overridden as needed by passing thewaitTimeSeconds
parameter with a desired value. The client should then retry the Request by following theLocation
header. - A HTTP
200
Response does not indicate that every batch item succeeded, but only that the batch calculation was completed. - Detailed information about the success or failure of the individual Requests within the batch is provided in the HTTP
200
Response. - The Batch Download GET Request is a blocking long poll request.
Request data
HTTP method: GET
URL format
For ease of viewing and identification:
- Required constants and parameters are shown in bold text.
- Optional parameters are shown in plain text.
https://baseURL/routing/versionNumber/batch/batchId?key=Your_API_Key&waitTimeSeconds=waitTimeSeconds
Example
https://api.tomtom.com/routing/1/batch/batchId?key=Your_API_Key
HTTP Request headers
The following table describes HTTP Request headers of particular interest to Batch Routing service clients.
Required headers | |
---|---|
Note: There are no required headers in this endpoint. | |
Optional headers | |
Header | Description |
Accept-Encoding string |
Should contain a list of encodings acceptable by the client. Used to demand a compressed Response. Value: gzip |
Accept string |
Indicates the format of the download error Response (e.g., a batch with a provided batchId does not exist). For instance, if a client submitted a batch with an output format set to json and would like to get the download error Response in the same format, the Accept header should be set to application/json . Otherwise the download error Response will have the default format which is xml .Note: In case of a successful Response, the Accept header value will not affect the batch Response format.Values:
|
Tracking-ID string |
Specifies an identifier for the Request.
Value: An identifier for the Request. |
Request parameters
The following table describes the Request parameters.
- Required parameters must be used or the call will fail.
- Optional parameters may be used.
- A parameter's data type is beneath its name.
Required parameters | |
---|---|
Parameter | Description |
baseURL string |
Base URL for calling the API: Value: api.tomtom.com |
versionNumber string |
Service version. Value: The current value is 1 . |
key string |
An API Key valid for the requested service. Value: Your valid API Key . |
batchId string |
The unique id of the batch returned in the HTTP Location header of the Batch Submission Response.Value: A unique ID. |
Optional parameters | |
Parameter | Description |
waitTimeSeconds integer |
Allows changing the maximum amount of time, in seconds, for which the client may have to wait for an Asynchronous Batch Download Response while the batch is being calculated.
Default value: |
Response data
HTTP Status codes
Code | Meaning and Possible Causes |
---|---|
200 |
OK: The batch job has completed. Results are streamed to the client. |
202 |
Accepted: The Request has been accepted for processing, but the processing has not been completed. A Location header is added to the Response containing a link to retry later. |
400 |
Bad Request: Missing required parameters, or parameters did not pass validation. |
403 |
Forbidden:
|
404 |
Not Found: The requested resource could not be found, for example a batch with a provided batchId does not exist. |
405 |
Method Not Allowed: The client used a HTTP method other than GET. |
408 |
Request timeout: The request sent to the server took longer than it was prepared to wait. |
414 |
Requested URI is too long: Indicates that the URI requested by the client is longer than the server is willing to interpret. |
429 |
Too Many Requests: The API Key is over QPS (Queries per second). |
500 |
An error occurred while processing the Request. Please try again later. |
502 |
Internal network connectivity issue. Please try again later. |
503 |
Service currently unavailable. Please try again later. |
504 |
Internal network connectivity issue or a request that has taken too long to complete. Please try again later. |
596 |
Service not found. Request contains an incorrect FQDN and/or path. |
Response headers
The following data table lists HTTP headers of particular interest to the service clients.
Header | Description |
---|---|
Access-Control-Expose-Headers |
A comma separated list of HTTP header names that browsers are allowed to access. Value: Content-Length |
Access-Control-Allow-Origin |
A header instructing browsers to allow customer websites to contact the Batch Routing service. Value: * |
Content-Encoding |
The Batch Routing service applies gzip compression to the responses if it is requested by the client with the Accept-Encoding header.Value: gzip |
Content-Type |
The format of the Response as chosen by the client. See the contentType Request parameter.Values:
|
Location |
Indicates the location where the batch results can be downloaded. Value: URI |
Tracking-ID |
An identifier for the Request.
Value: |
Successful Response structure
Each Batch Response consists of one or more batchItem
elements which correspond sequentially with the batchItem
elements in the Request. Each batchItem
element contains a successful Response from the invoked Routing API suite endpoint or a status code indicating why the batch item failed.
XML Response example
<?xml version="1.0" encoding="utf-8"?>
<batchResponse xmlns="http://api.tomtom.com/batch" formatVersion="0.0.1">
<batchItems>
<batchItem>
<statusCode>...</statusCode>
<response>
...
</response>
</batchItem>
...
<batchItem>
<statusCode>...</statusCode>
<response>
...
</response>
</batchItem>
</batchItems>
<summary>
<successfulRequests>...</successfulRequests>
<totalRequests>...</totalRequests>
</summary>
</batchResponse>
JSON Response example
{
"formatVersion": "0.0.1",
"batchItems": [
{
"statusCode": ...,
"response": {...}
},
...,
{
"statusCode": ...,
"response": {...}
}
],
"summary": {
"successfulRequests": ...,
"totalRequests": ...
}
}
Successful Response fields
Field | Description |
---|---|
batchResponse |
Root element of the batch Response. |
successfulRequests |
Number of successful batch item Requests. |
totalRequests |
Total number of items in batch Request. |
batchItems |
A set of batch items processing results. |
batchItem |
Contains results of processing of a single batch item. |
statusCode |
Status code of a Response from the underlying Routing API suite endpoint for given batch item. |
response |
Content of the Response from the underlying Routing API suite endpoint for a given batch item query.
|
summary |
Summary of the batch Request. |
Successful Response examples
To improve readability of the examples, the copyright and privacy sections inside batch items' Response are skipped.
Click to expand/collapse the following examples.
XML Response example
<?xml version="1.0" encoding="UTF-8"?>
<batchResponse xmlns="http://api.tomtom.com/batch" formatVersion="0.0.1">
<batchItems>
<batchItem>
<statusCode>200</statusCode>
<response>
<calculateRouteResponse xmlns="http://api.tomtom.com/routing" formatVersion="0.0.12">
<copyright>...</copyright>
<privacy>...</privacy>
<route>
<summary>
<lengthInMeters>223</lengthInMeters>
<travelTimeInSeconds>66</travelTimeInSeconds>
<trafficDelayInSeconds>0</trafficDelayInSeconds>
<departureTime>2016-04-22T13:21:30+02:00</departureTime>
<arrivalTime>2016-04-22T13:22:36+02:00</arrivalTime>
</summary>
<leg>
<summary>
<lengthInMeters>223</lengthInMeters>
<travelTimeInSeconds>66</travelTimeInSeconds>
<trafficDelayInSeconds>0</trafficDelayInSeconds>
<departureTime>2016-04-22T13:21:30+02:00</departureTime>
<arrivalTime>2016-04-22T13:22:36+02:00</arrivalTime>
</summary>
<points>
<point latitude="52.36006" longitude="4.85109" />
<point latitude="52.36084" longitude="4.85106" />
<point latitude="52.36176" longitude="4.85104" />
<point latitude="52.36176" longitude="4.85056" />
</points>
</leg>
<sections>
<section>
<startPointIndex>0</startPointIndex>
<endPointIndex>3</endPointIndex>
<travelMode>car</travelMode>
</section>
</sections>
</route>
</calculateRouteResponse>
</response>
</batchItem>
<batchItem>
<statusCode>400</statusCode>
<response>
<calculateRouteResponse xmlns="http://api.tomtom.com/routing" formatVersion="0.0.12">
<copyright>...</copyright>
<privacy>...</privacy>
<error description="Invalid travel mode value: [teleport]" />
</calculateRouteResponse>
</response>
</batchItem>
<batchItem>
<statusCode>200</statusCode>
<response>
<calculateReachableRangeResponse xmlns="http://api.tomtom.com/routing" formatVersion="0.0.1">
<copyright>...</copyright>
<privacy>...</privacy>
<reachableRange>
<center latitude="52.36176" longitude="4.85056" />
<boundary>
<point latitude="52.78716" longitude="4.81318" />
<point latitude="52.78983" longitude="4.79019" />
<point latitude="52.78346" longitude="4.70485" />
<point latitude="52.77541" longitude="4.67377" />
<point latitude="52.73947" longitude="4.64530" />
<point latitude="52.61481" longitude="4.64891" />
<point latitude="52.61362" longitude="4.64887" />
<point latitude="52.53855" longitude="4.65841" />
<point latitude="52.49834" longitude="4.64125" />
<point latitude="52.47165" longitude="4.60932" />
<point latitude="52.46203" longitude="4.58628" />
<point latitude="52.44705" longitude="4.59327" />
<point latitude="52.37132" longitude="4.52544" />
<point latitude="52.32164" longitude="4.57722" />
<point latitude="52.26437" longitude="4.45996" />
<point latitude="52.11393" longitude="4.28383" />
<point latitude="51.01315" longitude="2.37788" />
<point latitude="51.02757" longitude="2.42521" />
<point latitude="50.43132" longitude="2.84907" />
<point latitude="50.33847" longitude="2.92668" />
<point latitude="50.34035" longitude="3.46896" />
<point latitude="50.45216" longitude="3.76045" />
<point latitude="50.48706" longitude="4.08585" />
<point latitude="50.13129" longitude="4.49675" />
<point latitude="50.49117" longitude="4.61820" />
<point latitude="50.09545" longitude="5.13195" />
<point latitude="50.05438" longitude="5.20811" />
<point latitude="50.02166" longitude="5.69731" />
<point latitude="50.07049" longitude="5.73492" />
<point latitude="50.21669" longitude="6.23432" />
<point latitude="50.11697" longitude="6.43576" />
<point latitude="50.46513" longitude="6.70010" />
<point latitude="50.37483" longitude="7.41121" />
<point latitude="50.52358" longitude="7.67539" />
<point latitude="50.87047" longitude="7.96531" />
<point latitude="51.02269" longitude="7.82893" />
<point latitude="51.54443" longitude="8.10810" />
<point latitude="52.23340" longitude="9.25347" />
<point latitude="52.86505" longitude="8.23947" />
<point latitude="52.95622" longitude="8.56608" />
<point latitude="53.18553" longitude="8.10646" />
<point latitude="53.32431" longitude="6.87906" />
<point latitude="53.24864" longitude="6.46143" />
<point latitude="53.21977" longitude="5.98597" />
<point latitude="53.20076" longitude="5.64319" />
<point latitude="53.18381" longitude="5.45848" />
<point latitude="53.03505" longitude="5.23428" />
<point latitude="52.95193" longitude="5.07620" />
<point latitude="52.77310" longitude="4.95600" />
<point latitude="52.73059" longitude="4.89175" />
</boundary>
</reachableRange>
</calculateReachableRangeResponse>
</response>
</batchItem>
<batchItem>
<statusCode>200</statusCode>
<response>
<calculateReachableRangeResponse xmlns="http://api.tomtom.com/routing" formatVersion="0.0.1">
<copyright>...</copyright>
<privacy>...</privacy>
<reachableRange>
<center latitude="52.36178" longitude="4.85216" />
<boundary>
<point latitude="52.55238" longitude="4.83100" />
<point latitude="52.58994" longitude="4.81431" />
<point latitude="52.61593" longitude="4.75696" />
<point latitude="52.61907" longitude="4.73098" />
<point latitude="52.60065" longitude="4.72924" />
<point latitude="52.57070" longitude="4.69273" />
<point latitude="52.56251" longitude="4.66643" />
<point latitude="52.51827" longitude="4.65113" />
<point latitude="52.51005" longitude="4.65357" />
<point latitude="52.47165" longitude="4.60932" />
<point latitude="52.46203" longitude="4.58628" />
<point latitude="52.44705" longitude="4.59327" />
<point latitude="52.36490" longitude="4.57865" />
<point latitude="52.32644" longitude="4.58989" />
<point latitude="52.27725" longitude="4.51188" />
<point latitude="52.17816" longitude="4.40562" />
<point latitude="52.13246" longitude="4.39854" />
<point latitude="52.07782" longitude="4.40456" />
<point latitude="52.12844" longitude="4.54478" />
<point latitude="52.14059" longitude="4.65627" />
<point latitude="52.13539" longitude="4.69158" />
<point latitude="52.18747" longitude="4.76277" />
<point latitude="52.24121" longitude="4.81595" />
<point latitude="52.25268" longitude="4.82480" />
<point latitude="52.22580" longitude="4.85207" />
<point latitude="52.22231" longitude="4.86311" />
<point latitude="52.11528" longitude="4.91272" />
<point latitude="52.10137" longitude="4.91745" />
<point latitude="52.15657" longitude="4.95490" />
<point latitude="52.07171" longitude="5.03885" />
<point latitude="52.03613" longitude="5.06388" />
<point latitude="52.06045" longitude="5.09947" />
<point latitude="52.12534" longitude="5.11099" />
<point latitude="52.23269" longitude="5.04984" />
<point latitude="52.17824" longitude="5.18006" />
<point latitude="52.20486" longitude="5.27330" />
<point latitude="52.21371" longitude="5.33380" />
<point latitude="52.35807" longitude="5.35599" />
<point latitude="52.41557" longitude="5.38758" />
<point latitude="52.37996" longitude="4.97327" />
<point latitude="52.39278" longitude="4.96466" />
<point latitude="52.45905" longitude="5.03088" />
<point latitude="52.49351" longitude="5.03124" />
<point latitude="52.54294" longitude="5.02473" />
<point latitude="52.65326" longitude="5.07318" />
<point latitude="52.67429" longitude="5.07021" />
<point latitude="52.72101" longitude="5.02531" />
<point latitude="52.63597" longitude="4.95650" />
<point latitude="52.54702" longitude="4.87765" />
<point latitude="52.54899" longitude="4.86904" />
</boundary>
</reachableRange>
</calculateReachableRangeResponse>
</response>
</batchItem>
</batchItems>
<summary>
<successfulRequests>3</successfulRequests>
<totalRequests>4</totalRequests>
</summary>
</batchResponse>
JSON Response example
{
"formatVersion": "0.0.1",
"batchItems": [
{
"statusCode": 200,
"response": {
"formatVersion": "0.0.12",
"copyright": "...",
"privacy": "...",
"routes": [
{
"summary": {
"lengthInMeters": 223,
"travelTimeInSeconds": 66,
"trafficDelayInSeconds": 0,
"departureTime": "2016-04-22T13:43:25+02:00",
"arrivalTime": "2016-04-22T13:44:31+02:00"
},
"legs": [
{
"summary": {
"lengthInMeters": 223,
"travelTimeInSeconds": 66,
"trafficDelayInSeconds": 0,
"departureTime": "2016-04-22T13:43:25+02:00",
"arrivalTime": "2016-04-22T13:44:31+02:00"
},
"points": [
{
"latitude": 52.36006,
"longitude": 4.85109
},
{
"latitude": 52.36084,
"longitude": 4.85106
},
{
"latitude": 52.36176,
"longitude": 4.85104
},
{
"latitude": 52.36176,
"longitude": 4.85056
}
]
}
],
"sections": [
{
"startPointIndex": 0,
"endPointIndex": 3,
"travelMode": "car"
}
]
}
]
}
},
{
"statusCode": 400,
"response": {
"formatVersion": "0.0.12",
"copyright": "...",
"privacy": "...",
"error": {
"description": "Invalid travel mode value: [teleport]"
}
}
},
{
"statusCode": 200,
"response": {
"formatVersion": "0.0.1",
"copyright": "...",
"privacy": "...",
"reachableRange": {
"center": {
"latitude": 52.36176,
"longitude": 4.85056
},
"boundary": [
{
"latitude": 52.78716,
"longitude": 4.81318
},
{
"latitude": 52.78983,
"longitude": 4.79019
},
{
"latitude": 52.78346,
"longitude": 4.70485
},
{
"latitude": 52.77541,
"longitude": 4.67377
},
{
"latitude": 52.73947,
"longitude": 4.6453
},
{
"latitude": 52.61481,
"longitude": 4.64891
},
{
"latitude": 52.61362,
"longitude": 4.64887
},
{
"latitude": 52.53855,
"longitude": 4.65841
},
{
"latitude": 52.49834,
"longitude": 4.64125
},
{
"latitude": 52.47165,
"longitude": 4.60932
},
{
"latitude": 52.46203,
"longitude": 4.58628
},
{
"latitude": 52.44705,
"longitude": 4.59327
},
{
"latitude": 52.37132,
"longitude": 4.52544
},
{
"latitude": 52.32164,
"longitude": 4.57722
},
{
"latitude": 52.26437,
"longitude": 4.45996
},
{
"latitude": 52.11393,
"longitude": 4.28383
},
{
"latitude": 50.98539,
"longitude": 2.23052
},
{
"latitude": 50.98863,
"longitude": 2.35777
},
{
"latitude": 50.43132,
"longitude": 2.84907
},
{
"latitude": 50.33847,
"longitude": 2.92668
},
{
"latitude": 50.22934,
"longitude": 3.27133
},
{
"latitude": 50.45216,
"longitude": 3.76045
},
{
"latitude": 50.48706,
"longitude": 4.08585
},
{
"latitude": 49.98206,
"longitude": 4.51402
},
{
"latitude": 50.49117,
"longitude": 4.6182
},
{
"latitude": 50.09545,
"longitude": 5.13195
},
{
"latitude": 49.91044,
"longitude": 5.29447
},
{
"latitude": 50.02166,
"longitude": 5.69731
},
{
"latitude": 50.07049,
"longitude": 5.73492
},
{
"latitude": 50.21669,
"longitude": 6.23432
},
{
"latitude": 50.11697,
"longitude": 6.43576
},
{
"latitude": 50.46513,
"longitude": 6.7001
},
{
"latitude": 50.37483,
"longitude": 7.41121
},
{
"latitude": 50.52358,
"longitude": 7.67539
},
{
"latitude": 50.87047,
"longitude": 7.96531
},
{
"latitude": 51.02269,
"longitude": 7.82893
},
{
"latitude": 51.54443,
"longitude": 8.1081
},
{
"latitude": 52.2334,
"longitude": 9.25347
},
{
"latitude": 52.86505,
"longitude": 8.23947
},
{
"latitude": 52.95622,
"longitude": 8.56608
},
{
"latitude": 53.18553,
"longitude": 8.10646
},
{
"latitude": 53.32431,
"longitude": 6.87906
},
{
"latitude": 53.24864,
"longitude": 6.46143
},
{
"latitude": 53.21977,
"longitude": 5.98597
},
{
"latitude": 53.20076,
"longitude": 5.64319
},
{
"latitude": 53.18381,
"longitude": 5.45848
},
{
"latitude": 53.03505,
"longitude": 5.23428
},
{
"latitude": 52.95193,
"longitude": 5.0762
},
{
"latitude": 52.7731,
"longitude": 4.956
},
{
"latitude": 52.73059,
"longitude": 4.89175
}
]
}
}
},
{
"statusCode": 200,
"response": {
"formatVersion": "0.0.1",
"copyright": "...",
"privacy": "...",
"reachableRange": {
"center": {
"latitude": 52.36178,
"longitude": 4.85216
},
"boundary": [
{
"latitude": 52.55238,
"longitude": 4.831
},
{
"latitude": 52.58944,
"longitude": 4.81481
},
{
"latitude": 52.61593,
"longitude": 4.75696
},
{
"latitude": 52.61869,
"longitude": 4.73182
},
{
"latitude": 52.60065,
"longitude": 4.72924
},
{
"latitude": 52.5704,
"longitude": 4.69259
},
{
"latitude": 52.56248,
"longitude": 4.66803
},
{
"latitude": 52.51754,
"longitude": 4.65152
},
{
"latitude": 52.51005,
"longitude": 4.65357
},
{
"latitude": 52.47165,
"longitude": 4.60932
},
{
"latitude": 52.46203,
"longitude": 4.58628
},
{
"latitude": 52.44705,
"longitude": 4.59327
},
{
"latitude": 52.40392,
"longitude": 4.54964
},
{
"latitude": 52.34494,
"longitude": 4.58513
},
{
"latitude": 52.27725,
"longitude": 4.51188
},
{
"latitude": 52.17925,
"longitude": 4.40661
},
{
"latitude": 52.13387,
"longitude": 4.40049
},
{
"latitude": 52.08084,
"longitude": 4.4085
},
{
"latitude": 52.12844,
"longitude": 4.54478
},
{
"latitude": 52.14113,
"longitude": 4.6569
},
{
"latitude": 52.13626,
"longitude": 4.69284
},
{
"latitude": 52.18881,
"longitude": 4.76185
},
{
"latitude": 52.24121,
"longitude": 4.81595
},
{
"latitude": 52.25268,
"longitude": 4.8248
},
{
"latitude": 52.2258,
"longitude": 4.85207
},
{
"latitude": 52.22231,
"longitude": 4.86311
},
{
"latitude": 52.11528,
"longitude": 4.91272
},
{
"latitude": 52.10203,
"longitude": 4.91813
},
{
"latitude": 52.15657,
"longitude": 4.9549
},
{
"latitude": 52.07171,
"longitude": 5.03885
},
{
"latitude": 52.03868,
"longitude": 5.06395
},
{
"latitude": 52.06083,
"longitude": 5.09541
},
{
"latitude": 52.12659,
"longitude": 5.1081
},
{
"latitude": 52.23269,
"longitude": 5.04984
},
{
"latitude": 52.17824,
"longitude": 5.18006
},
{
"latitude": 52.20553,
"longitude": 5.27285
},
{
"latitude": 52.21432,
"longitude": 5.33036
},
{
"latitude": 52.35769,
"longitude": 5.3551
},
{
"latitude": 52.4155,
"longitude": 5.38742
},
{
"latitude": 52.37996,
"longitude": 4.97327
},
{
"latitude": 52.39278,
"longitude": 4.96466
},
{
"latitude": 52.45905,
"longitude": 5.03088
},
{
"latitude": 52.49351,
"longitude": 5.03124
},
{
"latitude": 52.54294,
"longitude": 5.02473
},
{
"latitude": 52.65356,
"longitude": 5.07229
},
{
"latitude": 52.67399,
"longitude": 5.06906
},
{
"latitude": 52.7202,
"longitude": 5.02538
},
{
"latitude": 52.63563,
"longitude": 4.9565
},
{
"latitude": 52.54702,
"longitude": 4.87765
},
{
"latitude": 52.54899,
"longitude": 4.86904
}
]
}
}
}
],
"summary": {
"successfulRequests": 3,
"totalRequests": 4
}
}
Error Response
The default error Response format is XML. It may be changed by using the Accept header.
Error Response example (XML)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<batchResponse xmlns="http://api.tomtom.com/batch" formatVersion="0.0.1">
<error description="Batch not found for provided id."/>
<detailedError>
<code>BatchNotFound</code>
<message>Batch not found for provided id.</message>
</detailedError>
</batchResponse>
Error Response example (JSON)
{
"formatVersion": "0.0.1",
"error": {
"description": "Batch not found for provided id."
},
"detailedError": {
"code": "BatchNotFound",
"message": "Batch not found for provided id."
}
}
Error Response fields
Primary fields | |
---|---|
Field | Description |
formatVersion string |
Version of the batch error Response format. |
error object |
Simplified information about the error.error{} object |
detailedError object |
Detailed information about the error.detailedError{} object |
error{} object |
|
Field | Description |
description string |
A human-readable description of the error. It is intended as an aid to developers and is not suitable for exposure to end users. |
detailedError{} object |
|
Field | Description |
code string |
One of the defined error codes. |
message string |
A human-readable description of the error code. It is intended as an aid to developers and is not suitable for exposure to end users. |
target string |
Optional. Target of the particular error. Values:
|
details array |
Optional. An array of root causes (more detailed errors) that led to this error. detailedError[] array |
innerError object |
Optional. A higher level of details about this error. innerError{} object |
innerError{} object |
|
Field | Description |
code string |
One of the defined error codes. |
message string |
Optional. A human-readable representation of the error code. It is intended as an aid to developers and is not suitable for exposure to end users. |
innerError object |
Optional. A higher level of details about this error. innerError{} object |
Error code hierarchy
List of predefined, hierarchical, human-readable error codes.
- Top level codes relate to HTTP error codes.
- They may be refined by error codes in
details
orinnerError
. - Further levels of refinement are possible by nesting
innerError
insideinnerError
.
In the future, the list may be extended with additional codes. The application must be ready for the occurrence of an unknown error code (e.g., by stopping error processing at the last understood level of detail).
Error code | Description |
---|---|
BadArgument |
One of the Request parameters did not pass validation. The Possible inner errors:
|
BatchNotFound |
Top level code for Requests which ended with HTTP 404 Not Found caused by requesting batchId which does not exist, or the batch being already expired. |
InvalidParameterValue |
The value of one of the parameters is invalid. |
InternalServerError |
Top level code for Requests which ended with HTTP 500 Internal Server Error . The service cannot handle the request right now, an unexpected condition was encountered. |
NotFound |
Top level code for Requests which ended with HTTP 404 Not Found caused by providing incorrect Request path. |
ServiceUnavailable |
Top level code for Requests which ended with HTTP 503 Service Unavailable . The service cannot handle the request right now, this is certainly a temporary state. |
ValueOutOfRange |
The value of one of the numeric parameters is out of the allowed range. |