List storages
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
| 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 |