Cancel an Order

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
DELETE /orders/{orderID}

Cancels an Order created by the authenticated User. Returns an empty body.

  • PENDING_PAYMENT / PENDING_APPROVAL - moved to CANCELLED, nothing was charged
  • PROCESSING / FAILED - the charge is reversed and the Order moves to REFUNDED

Orders in the following statuses cannot be cancelled (400, the reason is given in message):

  • FULFILLED - CANNOT_CANCEL_FULFILLED_ORDER
  • CANCELLED - ALREADY_CANCELLED_ORDER
  • REPLACED - CANNOT_CANCEL_REPLACED_ORDER
  • REFUNDED - ALREADY_REFUNDED_ORDER

Cancelling an IN_BASKET Order removes it from the basket.

To stop a delivered plan, cancel its Subscription instead.

Path parameters

  • orderID string Required

    ID of the Order

Responses

  • 200

    Order cancelled successfully (empty body)

  • 400 application/json

    Invalid request or refused by a business rule

    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
DELETE /orders/{orderID}
curl \
 --request DELETE 'https://zim.api.zimconnections.com/orders/ordr_GMAVA4ISiqfWSG0ArGOzB' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-App-Identifier: $API_KEY"
Response examples (400)
{
  "statusCode": 400,
  "message": [
    "property foo should not exist"
  ],
  "error": "Bad Request"
}
Response examples (404)
{
  "statusCode": 404,
  "message": "Record not found",
  "error": "Not Found"
}