Purpose

Retrieve a list of all private data storage locations associated with your account.

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/pdg/storages

URL example

get
URL example
https://api.tomtom.com/maps/orbis/platform/pdg/storages

curl command example

get
curl command example
1curl -X GET "https://api.tomtom.com/maps/orbis/platform/pdg/storages" \
2 -H "tomtom-api-key: YOUR_API_KEY" \
3 -H "Authorization: Bearer YOUR_AUTH_TOKEN" \
4 -H "X-Version: 1"

Request headers

HeaderRequiredDescription
tomtom-api-keyYesYour TomTom API key
AuthorizationYesBearer token from Azure CLI
X-VersionYesAPI version (use 1)

Response data

Response example

1{
2 "storages": [
3 {
4 "id": "storage-001",
5 "name": "Production Data",
6 "createdAt": "2026-01-15T09:00:00Z"
7 },
8 {
9 "id": "storage-002",
10 "name": "Test Environment",
11 "createdAt": "2026-01-18T14:30:00Z"
12 }
13 ]
14}

Response fields

FieldTypeDescription
storagesarrayList of storage objects
storages[].idstringUnique identifier for the storage
storages[].namestringHuman-readable name of the storage
storages[].createdAtstringISO 8601 timestamp of storage creation

Error responses

HTTP StatusErrorCauseSolution
401UnauthorizedInvalid credentialsRefresh API key or token
403ForbiddenInsufficient permissionsCheck your access rights
500Internal Server ErrorServer-side issueRetry the request