HERE

HERE Metadata API

Get information about catalogs, layers, and partitions

GitHub OpenAPI

Operations 29

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 /layerVersions Get layer versions for a catalog version · Gets layer versions for catalog version #
Ask an LLM
“Which version of each layer was part of a given catalog version?”
“What happens if I ask for layer versions of a catalog version that does not exist?”
Tell an agent
Get the layer versions that make up catalog version {version}.
Show layer versions for catalog version {version} billed to tag {billingTag}.
GET /layers/{layerId}/changes Get partition changes in a version or time range · Gets changes for the version range #
Ask an LLM
“Which partitions in a versioned layer changed between two catalog versions?”
“Can I see what changed in a volatile layer since a certain time?”
Tell an agent
Get partitions in layer {layerId} that changed between version {startVersion} and {endVersion}.
Show changes to volatile layer {layerId} since {sinceTime}.
GET /layers/{layerId}/changes/parts Split a layer's change query into parallel parts · Get partIds for parallel queries of changes for the version range #
Ask an LLM
“How can I fetch layer changes in parallel instead of one big query?”
“What part IDs should I use to divide a changes query across workers?”
Tell an agent
Get {numRequestedParts} part IDs for querying changes in layer {layerId} in parallel.
Split the changes query for layer {layerId} into {numRequestedParts} parts.
GET /layers/{layerId}/partitions Get metadata for all partitions in a layer · Gets partitions #
Ask an LLM
“What partitions exist in a layer of my HERE catalog?”
“Can I read partition metadata as of an older catalog version?”
Tell an agent
List the partitions in layer {layerId}.
Get partition metadata for layer {layerId} at catalog version {version}.
GET /layers/{layerId}/partitions/parts Split a layer's partition listing into parallel parts · Get partIds for parallel queries of the metadata for all partitions in a… #
Ask an LLM
“How do I list every partition of a huge layer using parallel requests?”
“Which part IDs divide a layer's partition metadata into chunks?”
Tell an agent
Get {numRequestedParts} part IDs for listing partitions of layer {layerId} in parallel.
Divide the partition metadata of layer {layerId} into {numRequestedParts} parts.
GET /versions List catalog versions · Gets catalog versions #
Ask an LLM
“What versions does my catalog have between two version numbers?”
“How many catalog versions can come back in a single call?”
Tell an agent
List catalog versions from {startVersion} to {endVersion}.
Get details about catalog version {version}.
POST /versions/compatibles Find catalog versions compatible with dependencies · Gets a list of available catalog versions that respect the given dependencies #
Ask an LLM
“Which versions of this catalog were built against the same dependency versions I use?”
“Can I require a strict match on every listed dependency HRN when checking compatibility?”
Tell an agent
Find catalog versions compatible with dependencies {dependencies}.
Return up to {limit} catalog versions that strictly match dependencies {dependencies}.
GET /versions/latest Get the latest catalog version · Gets the latest available catalog version #
Ask an LLM
“What is the newest version of my HERE catalog?”
“Has the catalog published anything newer than the version I last saw?”
Tell an agent
Get the latest catalog version, starting from version {startVersion}.
Check the most recent catalog version after {startVersion}.
GET /versions/minimum Get the earliest available catalog version · Gets the earliest available catalog version #
Ask an LLM
“What is the oldest catalog version still available?”
“How far back can I read versions of this catalog?”
Tell an agent
Get the minimum available catalog version.
Show the earliest catalog version billed to {billingTag}.
POST /versions/minimum Set the earliest catalog version and drop older ones · Sets the earliest available catalog version #
Ask an LLM
“How do I delete all catalog versions older than a certain one?”
“Is raising the minimum catalog version reversible?”
Tell an agent destructive · confirm first
Set the catalog's minimum version to {version}, deleting all prior versions.
Purge catalog versions before {version}.
GET /info List accepted values for map image parameters · Returns a list of accepted values for specific API parameters #
Ask an LLM
“What PPI values and styles can I request for a map image?”
“Which parameter values does the map image service accept?”
Tell an agent
Show the accepted values for map image parameters like PPI and style.
List valid map image request options.
GET /politicalViews List available geopolitical map views · Returns geopolitical views #
Ask an LLM
“Which country-specific geopolitical views can a map image be rendered with?”
“Can I show disputed borders the way a particular country sees them?”
Tell an agent
List the available geopolitical views for map images.
Show which country political views I can request.
GET /features List map features available per style · Returns features per style #
Ask an LLM
“Which optional map features can I turn on for each map style?”
“What features does a given style support in a map image request?”
Tell an agent
List the available map features for each style.
Show the per-style feature options for map images.
GET /languages List available map label languages · Returns the available map languages #
Ask an LLM
“In which languages can map labels be rendered?”
“Does the map image service support labels in Japanese?”
Tell an agent
List the languages available for map labels.
Show supported map language codes per resource.
GET /copyright Get map data copyright notices · Returns copyright information #
Ask an LLM
“What copyright text do I have to display with HERE map images?”
“Which areas does each map copyright notice apply to?”
Tell an agent
Get the map copyright information with its bounding boxes.
Show the attribution text I must display for map data.
GET /metadata/v2/health Check the tracking Metadata service health · Gets service health #
Ask an LLM
“Is the HERE Tracking Metadata service up right now?”
“Can I ping the tracking Metadata service before using it?”
Tell an agent
Check the health of the tracking Metadata service.
Tell me whether the tracking Metadata service is healthy.
GET /metadata/v2/version Get the tracking Metadata service version · Gets service version #
Ask an LLM
“What version of the tracking Metadata service is deployed?”
“Which build of the tracking Metadata service am I calling?”
Tell an agent
Get the version of the tracking Metadata service.
Show which tracking Metadata service version is running.
GET /metadata/v2/devices/{trackingId} Get a device's or shipment's metadata · Gets metadata of a device or a shipment #
Ask an LLM
“What custom metadata is stored on a tracker or shipment?”
“Can I read the metadata object of a shipment by its ID?”
Tell an agent
Get the metadata of device {trackingId}.
Show custom metadata stored on tracker {trackingId}.
PUT /metadata/v2/devices/{trackingId} Merge metadata into a device or shipment · Creates or updates metadata of a device or a shipment #
Ask an LLM
“Can I add custom key-value metadata to a tracker?”
“Does updating device metadata merge with what's already there?”
Tell an agent
Merge new metadata into device {trackingId}.
Set custom metadata on tracker {trackingId}.
DELETE /metadata/v2/devices/{trackingId} Delete all metadata of a device or shipment · Deletes all metadata of a device or a shipment #
Ask an LLM
“Can I wipe all custom metadata from a tracker?”
“What removes a shipment's metadata entirely?”
Tell an agent destructive · confirm first
Delete all metadata of device {trackingId}.
Clear custom metadata from tracker {trackingId}.
POST /metadata/v2/devices/batch Get metadata for many devices or shipments · Gets a batch of metadata of multiple devices or shipments #
Ask an LLM
“Can I fetch metadata for many trackers in a single request?”
“Is there a batch read for shipment metadata?”
Tell an agent
Get metadata for this batch of devices.
Fetch metadata for these trackers, {count} per page.
GET /metadata/v2/geofences/{geofenceId} Get a geofence's metadata · Gets metadata of a geofence #
Ask an LLM
“What custom metadata is attached to a geofence?”
“Can I read the metadata object of one geofence?”
Tell an agent
Get the metadata of geofence {geofenceId}.
Show custom metadata stored on geofence {geofenceId}.
PUT /metadata/v2/geofences/{geofenceId} Merge metadata into a geofence · Creates or updates metadata of a geofence #
Ask an LLM
“Can I attach custom key-value metadata to a geofence?”
“Does geofence metadata get merged or replaced on update?”
Tell an agent
Merge new metadata into geofence {geofenceId}.
Set custom metadata on geofence {geofenceId}.
DELETE /metadata/v2/geofences/{geofenceId} Delete all metadata of a geofence · Deletes all metadata of a geofence #
Ask an LLM
“Can I wipe the custom metadata from a geofence without deleting it?”
“What clears a geofence's metadata object?”
Tell an agent destructive · confirm first
Delete all metadata of geofence {geofenceId}.
Clear custom metadata from geofence {geofenceId}.
POST /metadata/v2/geofences/batch Get metadata for many geofences · Gets a batch of metadata of multiple geofences #
Ask an LLM
“Can I fetch metadata for many geofences in one request?”
“Is there a batch read for geofence metadata?”
Tell an agent
Get metadata for this batch of geofences.
Fetch geofence metadata, {count} per page.
GET /metadata/v2/sensorRules/{sensorRuleId} Get a sensor rule's metadata · Gets metadata of a sensor rule #
Ask an LLM
“What custom metadata is attached to a sensor rule?”
“Can I read the metadata of one sensor rule?”
Tell an agent
Get the metadata of sensor rule {sensorRuleId}.
Show custom metadata stored on sensor rule {sensorRuleId}.
PUT /metadata/v2/sensorRules/{sensorRuleId} Merge metadata into a sensor rule · Creates or updates metadata of a sensor rule #
Ask an LLM
“Can I attach custom metadata to a sensor rule?”
“Does sensor rule metadata merge with existing keys on update?”
Tell an agent
Merge new metadata into sensor rule {sensorRuleId}.
Set custom metadata on sensor rule {sensorRuleId}.
DELETE /metadata/v2/sensorRules/{sensorRuleId} Delete all metadata of a sensor rule · Deletes all metadata of a sensor rule #
Ask an LLM
“Can I wipe the custom metadata from a sensor rule?”
“What clears a sensor rule's metadata object?”
Tell an agent destructive · confirm first
Delete all metadata of sensor rule {sensorRuleId}.
Clear custom metadata from sensor rule {sensorRuleId}.
POST /metadata/v2/sensorRules/batch Get metadata for many sensor rules · Gets a batch of metadata for multiple sensor rules #
Ask an LLM
“Can I fetch metadata for many sensor rules in one request?”
“Is there a batch read for sensor rule metadata?”
Tell an agent
Get metadata for this batch of sensor rules.
Fetch sensor rule metadata, {count} per page.

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-metadata-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-metadata-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-metadata-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Here Metadata API
  x-refined-note:
  - x-olp-service differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged metadata across 4 of this provider''s published API definitions: here-data-metadata-v1-openapi.yml, here-map-image-v3-openapi.yml, here-raster-tile-v3-openapi.yml, here-tracking-v2-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://use.apilookup.for.a.base.url/
- url: https://image.maps.hereapi.com/mia/v3
  description: Production
- url: https://maps.hereapi.com/v3
  description: Production
- url: https://tracking.hereapi.com/
- url: https://tracking.api.here.com/
tags:


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