Latest Subscription's consumption report

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
GET /subscriptions/{subscriptionID}/activity/latest

Retrieve the latest consumption report for a Subscription owned by the caller.

  • Note: Consumption reports are updated automatically every hour.

Path parameters

  • subscriptionID string Required

    ID of the Subscription

Responses

  • 200 application/json

    Consumption report fetched successfully

    Hide response attributes Show response attributes object | null
    • currentBalanceBytes number

      The current balance in bytes for the Subscription

    • spentBalanceBytes number

      The spent balance in bytes for the Subscription

    • initialBalanceBytes number

      The initial balance in bytes for the Subscription

    • lastUpdatedAt string(date-time)

      The report's last update

  • 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
GET /subscriptions/{subscriptionID}/activity/latest
curl \
 --request GET 'https://zim.api.zimconnections.com/subscriptions/subs_BiPtvfzYKwcyNMNvTGmLO/activity/latest' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-App-Identifier: $API_KEY"
Response examples (200)
{
  "currentBalanceBytes": 94371840,
  "initialBalanceBytes": 104857600,
  "spentBalanceBytes": 10485760,
  "lastUpdatedAt": "2026-10-27T10:00:00.000Z"
}
Response examples (401)
{
  "statusCode": 401,
  "message": "Unauthorized"
}
Response examples (404)
{
  "statusCode": 404,
  "message": "Record not found",
  "error": "Not Found"
}