Global Entity Matcher (GEM)

List storages

Request access

Purpose

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

Request data

HTTP method: GET

URL format

get
URL format
https://api.tomtom.com/maps/orbis/platform/private-gateway/storages

curl command example

get
curl command example
curl -X GET "https://api.tomtom.com/maps/orbis/platform/private-gateway/storages" \
-H "tomtom-api-key: YOUR_API_KEY" \
-H "Authorization: Bearer YOUR_AUTH_TOKEN"

Request headers

HeaderRequiredDescription
tomtom-api-keyYesYour TomTom API key
AuthorizationYesBearer token from Azure CLI

Response data

Response example

{
"storages": [
{
"id": "storage-001",
"url": "https://storage-001.blob.core.windows.net/default/",
"type": "AZURE_BLOB_STORAGE"
},
{
"id": "storage-002",
"url": "https://storage-002.blob.core.windows.net/default/",
"type": "AZURE_BLOB_STORAGE"
}
]
}

Response fields

FieldTypeDescription
storagesarrayList of storage objects
storages[].idstringUnique identifier for the storage
storages[].urlstringURL address of storage
storages[].typestringType of storage, supported values: AZURE_BLOB_STORAGE

Error responses

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