How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
HERE

HERE Config API

Manages catalogs and layers.

Documentation Provider Profile APIs.io OpenAPI GitHub

HERE Config API is one of 139 APIs that HERE publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Config. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 22 operations across 13 paths, and defines 91 schemas. It is described by OpenAPI 3.2.0, at version 1.3.4.

Requests are made against a single base URL, https://use.apilookup.for.a.base.url/.

22 operations 13 paths 91 schemas 4 DELETE11 GET1 HEAD3 PATCH2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.3.4
Base URL
https://account.api.here.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

HERE Config API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (Bearer). By default, every request must be authenticated.

  • Bearer — A token obtained from a separate endpoint using client credentials and an OAuth 1.0a HMAC-SHA256 signed request. For more information on how to get a bearer to…

Paths & Operations 22

Across 13 paths, the API surfaces 22 operations — 4 DELETE, 11 GET, 1 HEAD, 3 PATCH, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Config 22

Manages catalogs and layers.

GET
/catalogs
Gets a list of all catalogs
ConfigAPIV1GetCatalogs 16 params → 200401403
POST
/catalogs
Creates a catalog
ConfigAPIV1CreateCatalog 1 param body → 202400401402403409
GET
/catalogs/context/{pageContext}
Gets a list of catalogs in the current page
ConfigAPIV1GetCatalogsPage 2 params → 200401403
GET
/catalogs/{catalogHrn}
Gets the details of a catalog
ConfigAPIV1GetCatalog 2 params → 200401403
HEAD
/catalogs/{catalogHrn}
Checks the existence of a catalog
ConfigAPIV1CatalogExists 2 params → 200401403404
PUT
/catalogs/{catalogHrn}
Updates a catalog
ConfigAPIV1UpdateCatalog 2 params body → 202400401402403409
PATCH
/catalogs/{catalogHrn}
Modify a catalog
ConfigAPIV1PatchCatalog 2 params body → 202400401402403404409
DELETE
/catalogs/{catalogHrn}
Deletes a catalog
ConfigAPIV1DeleteCatalog 2 params → 202401403409
PATCH
/catalogs/{catalogHrn}/status
Mark a catalog as disabled or re-enable catalog
ConfigAPIV1ChangeCatalogState 1 param body → 200400401403404409
GET
/catalogs/{catalogHrn}/status
Gets catalog status information
ConfigAPIV1GetCatalogState 1 param → 200401403404
PATCH
/catalogs/{catalogHrn}/layers/{layerId}
Modify a catalog layer
ConfigAPIV1PatchLayer 3 params body → 202400401402403404409
DELETE
/catalogs/{catalogHrn}/layers/{layerId}
Delete a layer
ConfigAPIV1DeleteLayer 3 params → 202400401403404409
GET
/catalogs/{catalogHrn}/subsetsdeprecated
Retrieves the details of all accessible subsets
ConfigAPIV1GetSubsets 4 params → 200401403
GET
/catalogs/{catalogHrn}/subsets/{subsetId}deprecated
Retrieve the details of a specific subset
ConfigAPIV1GetSubset 2 params → 200401403404
GET
/catalogs/{catalogHrn}/subsetsFingerprintdeprecated
Get Subsets Fingerprint
ConfigAPIV1GetSubsetsFingerprint 1 param → 200401403
GET
/catalogs/{catalogHrn}/dataSubsets
Retrieves the details of all accessible data subsets
ConfigAPIV1GetDataSubsets 5 params → 200401403
POST
/catalogs/{catalogHrn}/dataSubsets
Create data subsets
ConfigAPIV1CreateDataSubsets 1 param body → 202400401402403409
GET
/catalogs/{catalogHrn}/dataSubsets/{dataSubsetId}
Retrieve the details of a specific data subset
ConfigAPIV1GetDataSubset 2 params → 200401403404
DELETE
/catalogs/{catalogHrn}/dataSubsets/{dataSubsetId}
Delete a specific data subset
ConfigAPIV1DeleteDataSubset 2 params → 202401403409
GET
/catalogs/{catalogHrn}/dataSubsetsFingerprint
Get Data Subsets Fingerprint
ConfigAPIV1GetDataSubsetsFingerprint 1 param → 200401403
DELETE
/catalogs/{catalogHrn}/automaticVersionDeletion
Disable automatic version deletion
ConfigAPIV1DisableAutomaticVersionDeletion 2 params → 202400401403404409
GET
/status/{token}
Gets the status of a create, update or delete catalog request
ConfigAPIV1GetOperationStatus 3 params → 200201202303401403404410

Schemas 91

The contract defines 91 schemas that model the data the API accepts and returns. The most detailed are PatchLayer (19 properties), Catalog (18 properties), CreateCatalog (12 properties), PatchCatalog (10 properties). Each schema is shown below with its type and property counts.

VolatileVolume
object
Describes a catalog volatile volume to be used for storing the layer's data content. Specifies volatile properties values if they are not provided.
2 properties 1 required
DataSubsets
object
Describes the accessible data subsets based on different areas or layers.
1 property 1 required
Notifications
object
When set to true, a notification is written to the notification stream each time the version of the catalog changes. This field is optional, but you can update…
1 property
Organisation
object
1 property
VersionedLayer
Describes the catalog versioned layer properties.
ContentEncoding
string
Identifies whether the data is compressed. Can be updated only for the stream layer.
IndexDefinition
object
4 properties
Ttl
integer
The expiry time in milliseconds for data in this layer. Data is automatically removed after the specified time limit has elapsed. For volatile layers, the TTL…
DataSubsetAreasCreate
LayerName
string
The display name for the layer.
AutomaticVersionDeletion
object
2 properties
CatalogPendingStatus
object
Describes the status of the catalog modification action.
1 property
IndexProperties
object
2 properties
InteractiveMapProperties
object
4 properties
Owner
object
2 properties
LayerId
string
The ID to use when referring to this layer programmatically.
VersionedLayerPropertiesInGet
object
2 properties
CreateObjectstoreLayer
Describes properties of a catalog object store layer.
EncryptionType
string
Defines type of encryption to apply for data at rest. 'hereEncryption' is default and ensures that encryption keys are managed by HERE, 'cloudEncryption' uses…
DataSubset
Partitioning
object
Describes the way in which data is partitioned within the layer.
2 properties 1 required
LayerHrn
string
The HERE Resource Name (HRN) of the layer.
VolatileProperties
object
Properties that define the scale of the volatile layer.
2 properties 1 required
CatalogOperationSuccessStatus
object
Describes the status of the successful catalog creation operation including its href.
2 properties 1 required
PatchObjectStoreProperties
object
1 property
PatchStreamProperties
object
Properties that define the scale of the required streaming layer. dataInThroughputKbps and dataOutThroughputKbps can only be values multiple of 100. For instan…
2 properties
Digest
string
The digest algorithm used to calculate the checksum for the partitions in this layer. If specified, you can assume that all partitions in the layer, at every v…
CatalogFailureStatus
object
Describes the detailed status of the failed catalog creation operation.
2 properties
InteractiveMapsLayer
Describes the catalog interactive maps layer properties.
SecureHandles
boolean
Indicates if the layer metadata and blob are in a mode that secure dataHandles support. It supports only heretile layer partitioning. The produced dataHandles…
PartitioningScheme
string
The name of the partitioning scheme for the layer
SubsetsResponse
object
BETA Response body for the get subsets API that is useful for pagination.
5 properties 4 required
CatalogSummary
object
Describes the main properties of the catalog.
4 properties
VolatileLayer
Describes the catalog volatile layer properties.
ContentType
string
The MIME type of the data is stored in this layer. Cannot be updated for objectstore and interactivemap layers. The default value for interactivemap layer is a…
Replication
object
1 property
Coverage
object
The geographic area that this layer covers
1 property
LayerDescription
string
A detailed description of the layer and what it contains. This information appears on the 'Overview' tab when you open a layer in the platform portal.
ObjectstoreLayer
Describes the catalog objectstore layer properties.
ExtendsWithVersion
LayerCreated
string
The layer creation timestamp in ISO 8601 format.
ObjectStoreProperties
object
2 properties
StreamProperties
object
Properties that define the scale of the required streaming layer. It is recommended to provide all 3 properties when creating a streaming layer. Either combina…
3 properties
CreateStreamLayer
Describes properties of a catalog stream layer.
CatalogsListResult
Contains a list of catalogs the user has access to.
CatalogLink
object
Describes the status and href of the create/update/delete resource such as a catalog.
4 properties
DataSubsetsFingerprint
object
DataSubsetFingerprint is a combination of fields that indicate if anything was changed in the set of data subsets or if area scheme version was increased
5 properties 2 required
StatusLink
object
Describes the status and href of the create/update/delete resource such as a catalog.
4 properties
CatalogSuccessStatus
object
Describes the status of the successful catalog creation operation including its href.
2 properties
CRC
string
The CRC algorithm used to calculate the checksum for the partitions in this layers
CatalogStatusRequestBody
object
1 property 1 required
SubsetRestrictions
boolean
This field is deprecated on the catalog level. Use subsetRestrictions on the layer level only. Indicates if the subsetRestrictions for a layer is enabled or no…
SubsetsFingerprint
object
BETA If subsetRestrictions is not enabled, the subsetsFingerprint, subsets, and areas will be empty.
4 properties 3 required
VersionedLayerPropertiesInPost
object
2 properties
DurableVolume
object
Describes a catalog durable volume to be used for storing the layer's data content.
1 property 1 required
PatchIndexProperties
object
1 property
DataSubsetAreas
Subset
object
Describes the specific subset based on the included areas.
5 properties 5 required
CreateVolatileLayer
Describes properties of a catalog volatile layer.
DeprecatedPartitioningScheme
string
The name of the partitioning scheme for the layer
CreateVersionedLayer
Describes properties of a catalog versioned layer.
DataSubsetBaseCreate
object
3 properties 3 required
TtlHours
integer
The expiry time in hours for data in this layer. Data is automatically removed after the specified time limit has elapsed.
CatalogsResultBase
object
Describes base class.
1 property
AreaSchemeFingerprint
object
2 properties 2 required
DataSubsetBase
object
4 properties 4 required
CreateIndexLayer
Describes properties of a catalog index layer.
CatalogsSummaryListResult
Contains a list of catalog summaries the user has access to.
DataSubsetsResponse
object
Response body for the get data subsets API that is useful for pagination.
5 properties 4 required
DataSubsetLayers
PatchCatalog
object
Describes the modification of the catalog configuration.
10 properties
Schema
object
Describes a HRN for the layer schema. Can be updated by the user for any kind of layer.
1 property
CreateInteractiveMapsLayer
Describes properties of a catalog interactive maps layer.
ReplicationRegion
object
2 properties 1 required
DataSubsetCreate
LayerSummary
string
A one-sentence summary of the layer. You can see this summary when you browse a list of layers on the platform portal.
IndexLayer
Describes the catalog index layer properties.
BillingTags
array
List of billing tags a free-form tag which is used for grouping billing records together. If supplied, it must be between 4 - 16 characters, contain only alpha…
Catalog
object
Describes the catalog properties.
18 properties 10 required
PatchLayer
object
Describes the modification of the layer configuration.
19 properties
Extends
object
Extension definition that allows a layer's content to be based on an existing layer. Entities in the extension layer override features with the same ID in the…
2 properties 2 required
CatalogsList
object
List of the catalog configurations.
3 properties
CatalogsSummaryList
object
List of the catalog summaries
3 properties
Creator
object
1 property
AreaScheme
string
This field is deprecated on the catalog level. Use /catalogs/{catalogHrn}/dataSubsets to set areaScheme in the dataSubset instead. HERE Resource Name (HRN) of…
CreateCatalog
object
Describes the configuration of the catalog including its layer definitions.
12 properties 4 required
CatalogStatusResult
object
3 properties
Subsets
object
BETA Describes the accessible subsets based on different areas. If subsetRestrictions is not enabled, the result will be empty.
1 property 1 required
DataSubsetLayersCreate
Tags
array
Some keywords that help to find the layer when searching in the platform portal
StreamLayer
Describes the catalog stream layer properties.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

here-config-api-openapi.yml Raw ↑

Other APIs HERE publishes across the network.

HERE Geocoding and Search API
AE Profile APIs.io
HERE Autosuggest API
AE Profile APIs.io
HERE Tour Planning API
AE Profile APIs.io
HERE Public Transit API
AE Profile APIs.io
HERE Destination Weather API
AE Profile APIs.io
HERE Map Tile API
AE Profile APIs.io
HERE Map Image API
AE Profile APIs.io
HERE Tracking API
AE Profile APIs.io
HERE Positioning API
AE Profile APIs.io
HERE Parking API
AE Profile APIs.io
HERE Platform Data API
AE Profile APIs.io
HERE HD Live Map
AE Profile APIs.io
#Config
← Back to H APIs
API Details
ID
here:here-config-api
Base URL
https://account.api.here.com
Docs
https://docs.here.com/identity-and-access-management/reference
Provider
HERE
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=here-config-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/here-config-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of HERE Config API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.