Search UK domestic Plans

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 /plans/search/domestic

Returns the UK domestic Plans: monthly plans with unlimited calls and unlimited SMS, from 1GB to unlimited data. The body is optional.

application/json

Body

  • planCategory string

    Values are REGULAR, UNLIMITED, or MIXED.

  • discount object
    Hide discount attribute Show discount attribute object
    • code string

Responses

  • 201 application/json

    Success

    Hide response attributes Show response attributes object
    • id string
    • name string
    • scope string
      • LOCAL - single Destination * REGIONAL - a Region (several Destinations) * GLOBAL - worldwide coverage

      Values are LOCAL, REGIONAL, or GLOBAL.

    • category string

      Values are REGULAR, UNLIMITED, or MIXED.

    • type string
      • DATA - Data-only Plans * VOICE_AND_DATA - Plans including voice (and SMS) in addition to data

      Values are DATA or VOICE_AND_DATA.

    • isRecurring boolean

      true for recurring plans such as UK domestic plans

    • recurringInterval string | null

      Billing interval of recurring plans (MONTHLY for UK domestic plans), null for one-off plans

      Values are DAILY, WEEKLY, MONTHLY, YEARLY, or null.

    • destination object
      Hide destination attributes Show destination attributes object
      • name string
      • isoAlpha3 string
      • regions array[object]
        Hide regions attributes Show regions attributes object
        • name string
        • abbreviation string
      • scopes object

        Returned by GET /destinations/{iso3} only

        Hide scopes attributes Show scopes attributes object
        • local boolean
        • regional boolean
        • global boolean
    • region object
      Hide region attributes Show region attributes object
      • name string
      • abbreviation string
    • dataUnit string

      Possible values:

      • MB - MegaByte representation
      • GB - GigaByte representation

      Values are MB or GB.

    • dataValue number

      Details:

      • If dataValue >= 0 then the plan is capped to that amount of consumable data
      • If dataValue == -1 then the plan is unlimited and does not have a cap on consumable data
    • callUnit string

      Details:

      • MINUTES - Minutes representation
      • HOURS - Hours representation

      Values are MINUTES or HOURS.

    • callValue number

      Details:

      • If callValue >= 0 then the plan is capped to that amount of consumable call time
      • If callValue == -1 then the plan is unlimited and does not have a cap on call time
    • smsUnit string
    • smsValue number

      Details:

      • If smsValue >= 0 then the plan is capped to that amount of consumable SMS sent
      • If smsValue == -1 then the plan is unlimited and does not have a cap on SMS sent
    • durationUnit string
    • durationValue number
    • features array[object]
      Hide features attributes Show features attributes object
      • name string

        Possible values:

        • HOTSPOT - The plan does support the hotspot function
        • TOP_UP - The plan does support top up operations
        • 3G - The plan and its associated network supports speeds up to 3G
        • 4G - The plan and its associated network supports speeds up to 4G
        • 5G - The plan and its associated network supports speeds up to 5G

        Values are HOTSPOT, TOP_UP, 3G, 4G, or 5G.

      • category string

        Values are UTILITY, BILLING, or NETWORK.

    • prices array[object]
      Hide prices attributes Show prices attributes object
      • currencyISO string
      • value number

        The unit amount in minor units (e.g. cents, if supported), represented as a signed integer

      • minorUnitsExponent number

        Indicates the number of decimals in the price for currencies supporting this format or 0 for zero-decimal currencies such as JPY. Examples:

        • A USD price value of 490 with a minorUnitsExponent of 2 would be $4.90
        • A JPY price value of 775 with a minorUnitsExponent of 0 would be ¥775
      • discountedFrom number

        Present when a valid discountCode was applied — the price before discount, in minor units

    • createdAt string(date-time)
  • 400 application/json

    Invalid request or refused by a business rule

    Hide response attributes Show response attributes object
POST /plans/search/domestic
curl \
 --request POST 'https://zim.api.dev.zimconnections.com/plans/search/domestic' \
 --header "X-App-Identifier: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "planCategory": "REGULAR"
}'
Request example
{
  "planCategory": "REGULAR"
}
Response examples (201)
[
  {
    "id": "plan_ukD01gbQwErTyUiOpAs",
    "name": "United Kingdom - 1GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 1,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 450,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukD03gbAsDfGhJkLzXc",
    "name": "United Kingdom - 3GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 3,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 650,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukD05gbZxCvBnMqWeRt",
    "name": "United Kingdom - 5GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 5,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 800,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukD10gbPoIuYtReWqLk",
    "name": "United Kingdom - 10GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 10,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 1000,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukD20gbMnBvCxZlKjHg",
    "name": "United Kingdom - 20GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 20,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 1200,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukD50gbGfDsApOiUyTr",
    "name": "United Kingdom - 50GB - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "REGULAR",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": 50,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 1350,
        "minorUnitsExponent": 2
      }
    ]
  },
  {
    "id": "plan_ukDunlYtReWqAsDfGhJ",
    "name": "United Kingdom - Unlimited - Monthly",
    "isRecurring": true,
    "recurringInterval": "MONTHLY",
    "scope": "LOCAL",
    "category": "UNLIMITED",
    "type": "VOICE_AND_DATA",
    "destination": {
      "name": "United Kingdom",
      "isoAlpha3": "GBR"
    },
    "dataUnit": "GB",
    "dataValue": -1,
    "callUnit": "MINUTES",
    "callValue": -1,
    "smsUnit": "SMS",
    "smsValue": -1,
    "prices": [
      {
        "currencyISO": "gbp",
        "value": 1500,
        "minorUnitsExponent": 2
      }
    ]
  }
]
Response examples (400)
{
  "statusCode": 400,
  "message": [
    "property foo should not exist"
  ],
  "error": "Bad Request"
}