Cancel a Subscription

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/zim/doc/esim-api/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "eSIM API MCP server": {
    "url": "https://bump.sh/zim/doc/esim-api/mcp"
  }
}

Close
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.

Path parameters

  • subscriptionID string Required

    ID of the Subscription

Responses

  • 201 application/json

    Cancellation requested

    Hide response attribute Show response attribute object
    • message string
  • 401 application/json

    Missing or invalid access token or X-App-Identifier

    Hide response attributes Show response attributes object
  • 404 application/json

    Resource not found or not owned by your Account

    Hide response attributes Show response attributes object
  • 409 application/json

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

    Hide response attributes Show response attributes object
POST /subscriptions/{subscriptionID}/cancel
curl \
 --request POST 'https://zim.api.zimconnections.com/subscriptions/subs_BiPtvfzYKwcyNMNvTGmLO/cancel' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-App-Identifier: $API_KEY"
Response examples (201)
{
  "message": "Plan cancellation requested"
}
Response examples (401)
{
  "statusCode": 401,
  "message": "Unauthorized"
}
Response examples (404)
{
  "statusCode": 404,
  "message": "Record not found",
  "error": "Not Found"
}
Response examples (409)
{
  "statusCode": 409,
  "message": "subscription_not_cancellable",
  "error": "Conflict"
}