> For the complete documentation index, see [llms.txt](https://bump.sh/zim/doc/esim-api/llms.txt)

# Cancel a Subscription

> POST /subscriptions/{subscriptionID}/cancel
> 
> Requests the cancellation of an `ACTIVE` or `PENDING` Subscription. The request has no body.
> 
> Cancellation is asynchronous: the Subscription immediately moves to `CANCEL_PENDING` and then to `CANCELLED` once the network confirms. Any other status is refused with `409 subscription_not_cancellable`.



## Servers
- Production: https://zim.api.zimconnections.com (Production)
- Sandbox: https://zim.api.dev.zimconnections.com (Sandbox)


## Authentication methods
- Oauth2 & App identifier


## Parameters

### Path parameters

- **subscriptionID** (string)
  ID of the Subscription




## Responses
### 201
Cancellation requested

#### Body: application/json (object)
- **message** (string)


### 401
Missing or invalid access token or `X-App-Identifier`

#### Body: application/json (object)
- **statusCode** (integer)

- **message** (string | array[string])
  Human-readable reason, or one entry per invalid property for validation errors

- **error** (string)


### 404
Resource not found or not owned by your Account

#### Body: application/json (object)
- **statusCode** (integer)

- **message** (string | array[string])
  Human-readable reason, or one entry per invalid property for validation errors

- **error** (string)


### 409
The resource is in a state that does not allow the operation

#### Body: application/json (object)
- **statusCode** (integer)

- **message** (string | array[string])
  Human-readable reason, or one entry per invalid property for validation errors

- **error** (string)



[Powered by Bump.sh](https://bump.sh)
