HERE

HERE Notification API v2 API

The Notification API v2 API from HERE — 2 operation(s) for notification api v2.

Documentation GitHub OpenAPI

Operations 3

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

POST /subscriptions Subscribe to catalog change notifications · Subscribe for Catalog change notifications #

Ask an LLM

“How do I get notified when a catalog changes?”

“Can catalog change notifications be delivered to my own stream layer?”

Tell an agent

Subscribe to change notifications for catalog {catalogHrn}.

Send catalog {catalogHrn} change notifications to stream layer {streamLayerId}.

GET /layers/{notificationStreamLayerId} List notification subscriptions for a layer · Get all subscriptions for target layer #

Ask an LLM

“Which catalog change subscriptions feed a given notification layer?”

“Can I see all subscriptions targeting my stream layer?”

Tell an agent

List subscriptions for notification layer {layer_id}.

Show every catalog change subscription that targets layer {layer_id}.

DELETE /layers/{notificationStreamLayerId} Delete notification subscriptions for a layer · Delete subscriptions for provided catalogHRN and stream layer ID #

Ask an LLM

“Can I delete just some catalog change subscriptions by ID?”

“Is there a way to remove every subscription on a notification layer?”

Tell an agent destructive · confirm first

Delete subscriptions {subscription_ids} on notification layer {layer_id}.

Remove all subscriptions on layer {layer_id} with delete all set to {delete_all}.

Documentation

https://docs.here.com/identity-and-access-management/docs

https://docs.here.com/identity-and-access-management/reference

https://docs.here.com/data-api/docs

https://docs.here.com/data-api/reference

https://docs.here.com/usage/docs

https://docs.here.com/usage/reference

https://docs.here.com/destination-weather/docs

https://docs.here.com/destination-weather/reference

https://docs.here.com/ev-products/docs

https://docs.here.com/ev-products/reference

https://docs.here.com/fuel-prices/docs

https://docs.here.com/fuel-prices/reference

https://docs.here.com/geocoding-and-search/docs

https://docs.here.com/geocoding-and-search/reference

https://docs.here.com/routing/docs

https://docs.here.com/routing/reference

https://docs.here.com/positioning/docs

https://docs.here.com/positioning/reference

https://docs.here.com/indoor-map/docs

https://docs.here.com/indoor-map/reference

https://docs.here.com/transit/docs

https://docs.here.com/transit/reference

https://docs.here.com/map-attributes/docs

https://docs.here.com/map-attributes/reference

https://docs.here.com/map-rendering/docs

https://docs.here.com/map-rendering/reference

https://docs.here.com/workspace/docs

https://docs.here.com/workspace/reference

https://docs.here.com/tour-planning/docs

https://docs.here.com/tour-planning/reference

https://docs.here.com/tracking/docs

https://docs.here.com/tracking/reference

https://docs.here.com/traffic-api/docs

https://docs.here.com/traffic-api/reference

https://docs.here.com/wego-pro/docs

https://docs.here.com/wego-pro/reference

Specifications

https://raw.githubusercontent.com/api-evangelist/here/refs/heads/main/openapi/here-notification-api-v2-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-notification-api-v2-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

openapi: 3.2.0
info:
  title: Notification API v2 API
  description: This covers all APIs for Data Service Notification
  contact: {}
  version: 2.0.1
  x-olp-service:
    name: notification
    version: v2
servers:
- url: https://use.apilookup.for.a.base.url/
security:
- Bearer: []
tags:
- name: Notification API v2
paths:
  /subscriptions:
    post:
      tags:
      - Notification API v2
      summary: Subscribe for Catalog change notifications
      operationId: NotificationAPISubscribe
      parameters:
      - $ref: '#/components/parameters/billingTag'
      - $ref: '#/components/parameters/Authorization'
      requestBody:
        description: The subscription request object to create a subscription.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscribeRequest'
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: string
                example: '"3a7afa36-db1c-11e9-8a34-2a2ae2dbcce4"'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: string
                example: Bad Request
        '403':
          description: Forbidden - Access to target resource not available
          content:
            application/json:
              schema:
                type: string
                example: Forbidden - Access to target resource not available
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: string
                example: Internal Server Error
      x-olp-access-type: resource
      x-operation-id-source: normalized
      x-operation-id-original: Notification API subscribe
  /layers/{notificationStreamLayerId}:
    get:
      tags:
      - Notification API v2
      summary: Get all subscriptions for target layer
      operationId: NotificationAPIGetSubscriptions
      parameters:
      - $ref: '#/components/parameters/notificationStreamLayerId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                example: '[fc1f51c8-7de3-44aa-9949-aac922fc4601,4565f5bc-db1d-11e9-8a34-2a2ae2dbcce4]'
                items:
                  type: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: string
                example: Not Found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: string
                example: Internal Server Error
      x-olp-access-type: resource
      x-operation-id-source: normalized
      x-operation-id-original: Notification API getSubscriptions
    delete:
      tags:
      - Notification API v2
      summary: Delete subscriptions for provided catalogHRN and stream layer ID
      operationId: NotificationAPIDeleteSubscriptions
      parameters:
      - $ref: '#/components/parameters/notificationStreamLayerId'
      requestBody:
        description: The subscription request object to create a subscription.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteRequest'
      responses:
        '200':
          description: OK - Successfully deleted
        '404':
          description: Not Found - No provided subscriptions exist
          content:
            application/json:
              schema:
                type: string
                example: Not Found - No provided subscriptions exist
        '409':
          description: Some of the provided subscriptions does not exist. Returning subscriptions that do not exist.
          content:
            application/json:
              schema:
                type: string
                example: Some of the provided subscriptions does not exist. Returning subscriptions that do not exist.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: string
                example: Internal Server Error
      x-olp-access-type: resource
      x-operation-id-source: normalized
      x-operation-id-original: Notification API deleteSubscriptions
components:
  parameters:
    Authorization:
      name: Authorization
      in: header
      description: User authorization token
      required: false
      schema:
        type: string
    notificationStreamLayerId:
      name: notificationStreamLayerId
      in: path
      description: Stream Layer ID for which we are retrieving subscriptions for.
      required: true
      schema:
        type: string
    billingTag:
      name: billingTag
      in: query
      description: Billing Tag
      schema:
        type: string
  schemas:
    SubscribeRequest:
      type: object
      properties:
        attributes:
          type: array
          items:
            $ref: '#/components/schemas/Attribute'
        notificationCatalogHRN:
          type: string
          example: hrn:here:data::realm:notification-catalog
        notificationStreamLayerId:
          type: string
          example: notification-layer
    Attribute:
      type: object
      properties:
        layerIds:
          type: array
          items:
            type: string
            example: notification-layer
        subscriptionArea:
          $ref: '#/components/schemas/SubscriptionArea'
        subscriptionResultType:
          type: string
          enum:
          - SHORT
          - LIST
          - FULL
    DeleteRequest:
      type: object
      properties:
        deleteAll:
          type: boolean
        subscriptionIds:
          uniqueItems: true
          type: array
          items:
            type: string
            example: 46d1ca2b-cad0-44d1-8a67-099dc08a0d40
    SubscriptionArea:
      type: object
      required:
      - subscriptionType
      properties:
        subscriptionType:
          type: string
          example: WKT
      discriminator:
        propertyName: subscriptionType
        mapping:
          all: '#/components/schemas/SubscriptionAreaAll'
          wkt: '#/components/schemas/SubscriptionAreaInWKT'
          partitions: '#/components/schemas/SubscriptionAreaInPartitions'
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: '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 token, see the [Identity & Access Management Guide](https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/README.html).

        '
externalDocs:
  description: The developer guide and related API references are available here.
  url: https://www.here.com/docs/category/data-api