Sorry, you need to enable JavaScript to visit this website.

Download prepared data


Service version: 1
Last edit: 2019.10.15

On this page


This endpoint requests a url to download prepared, archived data.

Request data

HTTPS 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.

curl command

curl 'https://baseURL/locationHistory/versionNumber/download/token?key=Your_API_Key&adminKey=Your_Admin_Key'

Request parameters

The following table describes the parameters that can be used in a request.

  • Required parameters must be used or the call will fail.
  • Optional parameters may be used.
  • If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
  • The order of request parameters is not important.
Required parameters
Parameter Description
The base URL for calling the API.
Service version.
Value: 1
An API Key valid for the requested service.
Value: Your valid API Key.
An Admin Key valid for the provided API Key.
Value: Your valid Admin Key.
Token that represents the data to download.
Value: Generated token.
Optional parameters
This endpoint does not have any optional parameters.

▲ Return to top

Response data

Response body

The following JSON code block demonstrates a successful response from the API server.

  "url": "<string>"

Response fields

The following table describes all of the response fields.

Primary fields
Field Description
The URL that links to the file which will include all data that should be collected with the provided token.
  • As long as data is collected the URL will respond with a 202 HTTP Code.
  • When the File is prepared the URL will respond with a 200 HTTP Code.

HTTP response codes

Code Meaning & possible causes
200 OK: Data is ready.
202 Accepted: Data is being collected.
400 Bad request: Token not found.
403 Forbidden:
  • Provided Admin Key is invalid.
  • Admin Key missing.

▲ Return to top


Get an archive of the historical positions.

Request URL GET

Response body

File download will begin.

▲ Return to top