---
title: "Gets the status of the subscription create/delete process."
method: GET
path: "/subscriptions/status/{statusToken}"
tags: ["subscription"]
---

# Gets the status of the subscription create/delete process.

`GET /subscriptions/status/{statusToken}`

Returns the configuration of the subscription associated with the HRN.

## Path parameters

- `statusToken` string, required

## Query parameters

- `billingTag` string

## Response `200`

OK

- SubscriptionStatus
  - `status` 'pending' | 'failed' | 'active' | 'deleted', required — Status: * `pending` - Operation is in progress. * `failed` - The operation failed. * `active` - Subscription was successfully created and is active. * `deleted` - Subscription was successfully deleted.
  - `subscriptionHrn` string — The HERE Resource Name (HRN) of the newly created subscription.

## Other responses

- `400` — Bad Request - indicates that your request failed fast validation due to an issue, such as syntax or logical errors.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found - no action is associated with the provided token.

---

[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)