HERE

HERE Config API

Manages catalogs and layers.

GitHub OpenAPI

Operations 22

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 /catalogs List the data catalogs I can access · Gets a list of all catalogs #
Ask an LLM
“Which HERE platform catalogs does my account have access to?”
“Can I filter the catalog list by layer type or region?”
Tell an agent
List all catalogs I have access to.
List catalogs matching {search} sorted by {sort_by}.
POST /catalogs Create a new data catalog · Creates a catalog #
Ask an LLM
“How do I create a new catalog with layers on the HERE platform?”
“Is catalog creation synchronous or do I get a token to poll?”
Tell an agent
Create a catalog with id {id} named {name} and summary {summary}.
Create catalog {id} called {name} with the layers {layers}.
GET /catalogs/context/{pageContext} Get the next page of a catalog listing · Gets a list of catalogs in the current page #
Ask an LLM
“What do I do when my catalog list comes back split across pages?”
“Can I fetch a specific page of catalogs using a page context?”
Tell an agent
Get the catalogs page for page context {page_context}.
Fetch the next page of my catalog list using context {page_context}.
GET /catalogs/{catalogHrn} Get a catalog's full configuration · Gets the details of a catalog #
Ask an LLM
“How can I see the layer definitions configured in one catalog?”
“What does the full configuration of a single catalog include?”
Tell an agent
Show the full configuration of catalog {catalog_hrn}.
Get the layers and layer types defined in catalog {catalog_hrn}.
HEAD /catalogs/{catalogHrn} Check whether a catalog exists · Checks the existence of a catalog #
Ask an LLM
“Is there a quick way to check if a catalog HRN exists?”
“Can I test for a catalog's existence without downloading its config?”
Tell an agent
Check whether catalog {catalog_hrn} exists.
Confirm the HRN {catalog_hrn} points to an existing catalog.
PUT /catalogs/{catalogHrn} Replace a catalog's configuration · Updates a catalog #
Ask an LLM
“How do I replace a catalog's whole configuration with a new version?”
“Does a full catalog update require resending id, name and summary?”
Tell an agent
Replace the configuration of catalog {catalog_hrn} with name {name} and summary {summary}.
Send a complete new configuration for catalog {catalog_hrn} including layers {layers}.
PATCH /catalogs/{catalogHrn} Change a few fields on a catalog · Modify a catalog #
Ask an LLM
“Can I change just a catalog's description without resending everything?”
“How do I turn on delete protection for a catalog?”
Tell an agent
Change the description of catalog {catalog_hrn} to {description}.
Set delete protection on catalog {catalog_hrn} to {delete_protected}.
DELETE /catalogs/{catalogHrn} Delete a catalog and its layers · Deletes a catalog #
Ask an LLM
“What happens to the layers when I delete a catalog?”
“Can I permanently remove a catalog I no longer need?”
Tell an agent destructive · confirm first
Delete catalog {catalog_hrn} and all of its layers.
Permanently remove the catalog {catalog_hrn}.
PATCH /catalogs/{catalogHrn}/status Disable or re-enable a catalog · Mark a catalog as disabled or re-enable catalog #
Ask an LLM
“Can I temporarily disable a catalog and turn it back on later?”
“What's the way to mark a catalog as disabled?”
Tell an agent
Set catalog {catalog_hrn} disabled to {disabled}.
Re-enable the disabled catalog {catalog_hrn} by setting disabled to {disabled}.
GET /catalogs/{catalogHrn}/status See whether a catalog is enabled or disabled · Gets catalog status information #
Ask an LLM
“Who disabled this catalog and when?”
“How can I tell if a catalog is currently enabled?”
Tell an agent
Show the enabled or disabled status of catalog {catalog_hrn}.
Find out who last changed the status of catalog {catalog_hrn}.
PATCH /catalogs/{catalogHrn}/layers/{layerId} Modify a catalog layer's settings · Modify a catalog layer #
Ask an LLM
“Can I change the TTL or tags on an existing layer?”
“How do I update a layer's summary and description only?”
Tell an agent
Set the TTL of layer {layer_id} in catalog {catalog_hrn} to {ttl}.
Change the description of layer {layer_id} in catalog {catalog_hrn} to {description}.
DELETE /catalogs/{catalogHrn}/layers/{layerId} Delete a layer from a catalog · Delete a layer #
Ask an LLM
“How do I remove a single layer from a catalog without deleting the catalog?”
“Can I drop one layer I no longer use?”
Tell an agent destructive · confirm first
Delete layer {layer_id} from catalog {catalog_hrn}.
Remove the {layer_id} layer in catalog {catalog_hrn}.
GET /catalogs/{catalogHrn}/subsets List subsets with the deprecated endpoint · Retrieves the details of all accessible subsets #
Ask an LLM
“Which subsets containing a given area can I access using the old subsets endpoint?”
“Is the legacy subsets listing still available?”
Tell an agent
List subsets of catalog {catalog_hrn} for areas {areas} using the deprecated subsets endpoint.
Show all legacy subsets I can access in catalog {catalog_hrn}.
GET /catalogs/{catalogHrn}/subsets/{subsetId} Get one subset via the deprecated endpoint · Retrieve the details of a specific subset #
Ask an LLM
“Can I still read a single subset through the old subsets route?”
“How do I look up a legacy subset by its ID?”
Tell an agent
Get legacy subset {subset_id} in catalog {catalog_hrn}.
Show the details of old-style subset {subset_id} from catalog {catalog_hrn}.
GET /catalogs/{catalogHrn}/subsetsFingerprint Get the legacy subsets fingerprint · Get Subsets Fingerprint #
Ask an LLM
“Is there a fingerprint of my accessible subsets on the deprecated endpoint?”
“What does the old subsets fingerprint represent?”
Tell an agent
Get the legacy subsets fingerprint for catalog {catalog_hrn}.
Fetch my deprecated subset configuration fingerprint in catalog {catalog_hrn}.
GET /catalogs/{catalogHrn}/dataSubsets List accessible data subsets · Retrieves the details of all accessible data subsets #
Ask an LLM
“Which data subsets can I access for a given area or layer?”
“Can I filter data subsets by layer IDs?”
Tell an agent
List data subsets in catalog {catalog_hrn} covering areas {areas}.
Show data subsets of catalog {catalog_hrn} for layers {layers}.
POST /catalogs/{catalogHrn}/dataSubsets Create data subsets in a catalog · Create data subsets #
Ask an LLM
“How many data subsets can I create in one request?”
“Is creating data subsets asynchronous with a status link?”
Tell an agent
Create new data subsets in catalog {catalog_hrn}.
Add a batch of data subsets to catalog {catalog_hrn} and return the status link.
GET /catalogs/{catalogHrn}/dataSubsets/{dataSubsetId} Get one data subset · Retrieve the details of a specific data subset #
Ask an LLM
“How do I see the details of one data subset?”
“What is defined in a specific data subset of my catalog?”
Tell an agent
Get data subset {data_subset_id} in catalog {catalog_hrn}.
Show the configuration of data subset {data_subset_id} from catalog {catalog_hrn}.
DELETE /catalogs/{catalogHrn}/dataSubsets/{dataSubsetId} Delete a data subset · Delete a specific data subset #
Ask an LLM
“Can I delete one data subset and track the deletion status?”
“What's returned when a data subset is removed?”
Tell an agent destructive · confirm first
Delete data subset {data_subset_id} from catalog {catalog_hrn}.
Remove the data subset {data_subset_id} in catalog {catalog_hrn} and give me the status link.
GET /catalogs/{catalogHrn}/dataSubsetsFingerprint Get the data subsets fingerprint · Get Data Subsets Fingerprint #
Ask an LLM
“Can I detect when my accessible data subset configuration has changed?”
“What is a data subsets fingerprint used for?”
Tell an agent
Get the data subsets fingerprint for catalog {catalog_hrn}.
Fetch the fingerprint of my accessible data subsets in catalog {catalog_hrn}.
DELETE /catalogs/{catalogHrn}/automaticVersionDeletion Turn off automatic version deletion · Disable automatic version deletion #
Ask an LLM
“How do I stop retired catalog versions from being cleaned up automatically?”
“Can I disable automatic version deletion on a catalog?”
Tell an agent destructive · confirm first
Disable automatic version deletion for catalog {catalog_hrn}.
Stop the automatic cleanup of retired versions in catalog {catalog_hrn}.
GET /status/{token} Check a catalog create, update or delete request · Gets the status of a create, update or delete catalog request #
Ask an LLM
“How do I track whether my catalog creation finished?”
“Where can I check progress of a catalog delete I submitted?”
Tell an agent
Check the status of catalog request token {token}.
Tell me if the catalog operation with token {token} has completed.

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-config-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-config-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-config-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: The `config` service provides basic catalog management operations. It manages all platform resources needed for different kinds of catalogs and operations on them.
  version: 1.3.4
  title: v1 Config API
  x-olp-service:
    name: config
    version: v1
servers:
- url: https://use.apilookup.for.a.base.url/
security:
- Bearer: []
tags:


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