---
title: "Gets a list of all subscriptions."
method: GET
path: "/subscriptions"
tags: ["subscription"]
---

# Gets a list of all subscriptions.

`GET /subscriptions`

Lists all subscriptions that your account has access to.

## Query parameters

- `billingTag` string
- `limit` integer
- `pageToken` string

## Response `200`

Paginated list of subscription configurations.

- SubscriptionList
  - `limit` integer, required — Current page size limit.
  - `nextPageToken` string
  - `previousPageToken` string
  - `items` SubscriptionInteractiveMapLayer[], required
    - `subscriptionName` string, required — The ID to use when referring to this subscription programmatically.
    - `subscriptionHrn` string — The HERE Resource Name (HRN) of subscription
    - `description` string — A detailed description of the subscription.
    - `sourceCatalog` string, required — The HERE Resource Name (HRN) of the subscription source catalog.
    - `sourceLayer` string, required — The ID of the subscription source layer.
    - `destinationCatalog` string, required — The HERE Resource Name (HRN) of the subscription destination catalog.
    - `destinationLayer` string, required — The ID of the subscription destination layer.
    - `owner` object, required — Information about the subscription's creator.
      - `creator` Creator, required
        - `id` string — The unique ID of the user or application that initially created the catalog
      - `organisation` Organisation, required
        - `id` string — The ID of the customer organisation relating to this catalog
    - `version` integer, required — Version of the subscription configuration.
    - `created` string, required — The subscription creation timestamp in ISO 8601 format.
    - `updated` string, required — The subscription's last update timestamp in ISO 8601 format.
    - `status` object, required — Subscription status information.
      - `state` 'active' | 'failed' | 'deleted', required — State: * `active` - Subscription was created successfully and is active. * `failed` - The operation failed. * `deleted` - Subscription was deleted successfully. * `disabled` - Subscription in disable state because the source catalog/layer or target catalog/layer was removed.
      - `message` string
    - `interactiveMapSubscription` object, required — Interactive map subscription.
      - `type` 'perFeature' | 'perTransaction' | 'contentChange', required — Type: * `perFeature` - Per feature interactive map subscription type. * `perTransaction` - Per transaction interactive map subscription type. * `contentChange` - Content change interactive map subscription type.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)