---
title: "Gets status of batch subscripton creation"
method: GET
path: "/subscriptions/batch/status/{statusToken}"
tags: ["subscription"]
---

# Gets status of batch subscripton creation

`GET /subscriptions/batch/status/{statusToken}`

Status of batch subscription creation

## Path parameters

- `statusToken` string, required

## Response `200`

OK

- BatchSubscriptionStatusResponse
  - `batchRequestId` string, required — Unique identifier for the batch subscription request.
  - `status` 'PENDING' | 'SUCCESS' | 'FAILED', required
  - `subscriptions` SubscriptionStatus[], required — Status of each subscription in the batch request.
    - `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)