HERE

HERE Aliases API

An alias is an arbitrary `type` - `externalId` pair, which can be associated with a `trackingId`. The `externalId` can be, for example, an external management system asset ID or a human-readable name. An alias is uniquely identified by an `externalId` and a `type` pair within a tracking project. > **IMPORTANT** > Aliases v2 API is deprecated.

GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /aliases/v2/health Check the Aliases service health · Gets service health #
Ask an LLM
“Is the HERE Tracking Aliases service up right now?”
“Can I ping the Aliases service before sending it requests?”
Tell an agent
Check the health of the Aliases service.
Tell me whether the Aliases service is healthy.
GET /aliases/v2/version Get the Aliases service version · Gets service version #
Ask an LLM
“What version of the Aliases service is deployed?”
“Which build of the Aliases service am I talking to?”
Tell an agent
Get the version of the Aliases service.
Show me which Aliases service version is running.
GET /aliases/v2 List all device aliases in a project · Gets all aliases #
Ask an LLM
“Which aliases exist across all devices in my tracking project?”
“Can I find aliases whose external ID matches a wildcard pattern?”
Tell an agent
List every alias in project {projectId}.
Find project aliases of type {type} matching external ID pattern {externalId}.
GET /aliases/v2/{trackingId} List all aliases of one device · Gets all aliases of a device #
Ask an LLM
“What aliases does a specific tracked device have?”
“Can I see every alias attached to a single tracking ID?”
Tell an agent
List all aliases of device {trackingId}.
Show device {trackingId}'s aliases, {count} at a time.
DELETE /aliases/v2/{trackingId} Delete every alias of a device · Deletes all aliases of a device #
Ask an LLM
“Can I wipe all aliases from a device in one call?”
“What confirmation is needed to remove all of a device's aliases?”
Tell an agent destructive · confirm first
Delete all aliases of device {trackingId}, confirming with x-confirm {confirm}.
Remove every alias, of every type, from device {trackingId}.
GET /aliases/v2/{trackingId}/{type} List a device's aliases of one type · Gets all aliases of a specified type for a device #
Ask an LLM
“Which aliases of a particular type does a device have?”
“Can I list just one kind of alias for a tracking ID?”
Tell an agent
List aliases of type {type} for device {trackingId}.
Show device {trackingId}'s {type} aliases only.
DELETE /aliases/v2/{trackingId}/{type} Delete a device's aliases of one type · Deletes all aliases of a specified type for a device #
Ask an LLM
“Can I remove only the aliases of a single type from a device?”
“Is it possible to clear one alias type while keeping the others on a device?”
Tell an agent destructive · confirm first
Wipe only the {type}-type aliases on {trackingId}, passing x-confirm {confirm}.
Clear the {type} aliases from device {trackingId}, keeping other alias types.
GET /aliases/v2/trackingId Find the device that owns an alias · Gets the tracking ID associated with an alias #
Ask an LLM
“Which tracking ID does a given external ID map to?”
“If I only know a device's alias, can I look up its tracking ID?”
Tell an agent
Get the tracking ID for alias {externalId} of type {type}.
Resolve {type} alias {externalId} in project {projectId} to a tracking ID.
PUT /aliases/v2/{trackingId}/{type}/{externalId} Add one alias to a device · Creates an alias #
Ask an LLM
“How do I give a tracked device a friendly external ID?”
“Does an alias have to be unique within a project?”
Tell an agent
Create alias {externalId} of type {type} for device {trackingId}.
Tag device {trackingId} with the single {type} alias {externalId}.
DELETE /aliases/v2/{trackingId}/{type}/{externalId} Delete one specific alias of a device · Deletes an alias #
Ask an LLM
“Can I remove just one alias from a device and keep the rest?”
“What happens if I delete a single external ID alias?”
Tell an agent destructive · confirm first
Delete alias {externalId} of type {type} from device {trackingId}.
Remove the single {type} alias {externalId} on device {trackingId}.
PUT /aliases/v2/{trackingId}/batch Add several aliases to a device at once · Creates multiple aliases for a device #
Ask an LLM
“Can I create multiple aliases for one device in a single request?”
“Is there a bulk way to assign aliases to a tracker?”
Tell an agent
Create aliases {aliases} for device {trackingId} in one batch.
Bulk-add the aliases {aliases} to device {trackingId}.

Documentation

📖
Documentation
https://docs.here.com/identity-and-access-management/docs
📖
APIReference
https://docs.here.com/identity-and-access-management/reference
📖
Documentation
https://docs.here.com/data-api/docs
📖
APIReference
https://docs.here.com/data-api/reference
📖
Documentation
https://docs.here.com/usage/docs
📖
APIReference
https://docs.here.com/usage/reference
📖
Documentation
https://docs.here.com/destination-weather/docs
📖
APIReference
https://docs.here.com/destination-weather/reference
📖
Documentation
https://docs.here.com/ev-products/docs
📖
APIReference
https://docs.here.com/ev-products/reference
📖
Documentation
https://docs.here.com/fuel-prices/docs
📖
APIReference
https://docs.here.com/fuel-prices/reference
📖
Documentation
https://docs.here.com/geocoding-and-search/docs
📖
APIReference
https://docs.here.com/geocoding-and-search/reference
📖
Documentation
https://docs.here.com/routing/docs
📖
APIReference
https://docs.here.com/routing/reference
📖
Documentation
https://docs.here.com/positioning/docs
📖
APIReference
https://docs.here.com/positioning/reference
📖
Documentation
https://docs.here.com/indoor-map/docs
📖
APIReference
https://docs.here.com/indoor-map/reference
📖
Documentation
https://docs.here.com/transit/docs
📖
APIReference
https://docs.here.com/transit/reference
📖
Documentation
https://docs.here.com/map-attributes/docs
📖
APIReference
https://docs.here.com/map-attributes/reference
📖
Documentation
https://docs.here.com/map-rendering/docs
📖
APIReference
https://docs.here.com/map-rendering/reference
📖
Documentation
https://docs.here.com/workspace/docs
📖
APIReference
https://docs.here.com/workspace/reference
📖
Documentation
https://docs.here.com/tour-planning/docs
📖
APIReference
https://docs.here.com/tour-planning/reference
📖
Documentation
https://docs.here.com/tracking/docs
📖
APIReference
https://docs.here.com/tracking/reference
📖
Documentation
https://docs.here.com/traffic-api/docs
📖
APIReference
https://docs.here.com/traffic-api/reference
📖
Documentation
https://docs.here.com/wego-pro/docs
📖
APIReference
https://docs.here.com/wego-pro/reference

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-aliases-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/here:here-aliases-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

here-aliases-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 2.6.11
  title: HERE Tracking Aliases API
  description: 'HERE Tracking is a cloud product designed to address location tracking problems for a wide range of Location IoT industry verticals.


    HERE Tracking also includes end-user mobile and web applications that can be used to demonstrate the product.'
  license:
    name: HERE Documentation License
    url: https://legal.here.com/en-gb/terms/documentation-license
servers:
- url: https://tracking.hereapi.com/
- url: https://tracking.api.here.com/
tags:


# --- truncated at 32 KB (77 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-aliases-api-openapi.yml