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": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"url": "https://mystorageaccount001.blob.core.windows.net/default/",
"type": "AZURE_BLOB_STORAGE"
},
{
"id": "9b2f6c1d-3e8a-4f5b-a1c7-d4e9f0b3a625",
"url": "https://mystorageaccount002.blob.core.windows.net/default/",
"type": "AZURE_BLOB_STORAGE"
}
]
}

Response fields

FieldTypeDescription
storagesarrayList of storage objects
storages[].idstring (uuid)Unique 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