List storages

Request access

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

1
https://api.tomtom.com/maps/orbis/platform/private-gateway/storages

URL example

get

URL example

1
https://api.tomtom.com/maps/orbis/platform/private-gateway/storages

curl command example

get

curl command example

1
curl -X GET "https://api.tomtom.com/maps/orbis/platform/private-gateway/storages" \
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
  "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

Field	Type	Description
`storages`	array	List of storage objects
`storages[].id`	string	Unique identifier for the storage
`storages[].name`	string	Human-readable name of the storage
`storages[].createdAt`	string	ISO 8601 timestamp of storage creation

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

List storages

Purpose

Request data

HTTP method: GET

URL format

URL example

curl command example

Request headers

Response data

Response example

Response fields

Error responses

HTTP method: `GET`