Retrieve an eSIM's installation details

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 /esims/{esimID}/config

Returns everything needed to install the eSIM manually (activation code, SM-DP+ address, matching ID) or from a QR code.

Path parameters

  • esimID string Required

    ID (or ICCID) of the eSIM

Responses

  • 200 application/json

    eSIM installation details

    Hide response attributes Show response attributes object
    • activationCode string

      Full activation code, as encoded in the QR code

    • smdpAddress string
    • matchingId string
    • qrCodeUrl string(uri)

      Short-lived signed URL to the QR code image

  • 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 /esims/{esimID}/config
curl \
 --request GET 'https://zim.api.dev.zimconnections.com/esims/esim_igFqGZhkRTHb0UNiRuAAA/config' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-App-Identifier: $API_KEY"
Response examples (200)
{
  "activationCode": "LPA:1$smdpp.zimconnections.com$2DAC33FBEB7D5A0C2F34659AF7A7842F5",
  "smdpAddress": "smdpp.zimconnections.com",
  "matchingId": "2DAC33FBEB7D5A0C2F34659AF7A7842F5",
  "qrCodeUrl": "https://example.com"
}
Response examples (401)
{
  "statusCode": 401,
  "message": "Unauthorized"
}
Response examples (404)
{
  "statusCode": 404,
  "message": "Record not found",
  "error": "Not Found"
}