Sign inGet Started
Get started
Guides
API Reference
SDKs
CLI
Knowledge Base
Changelog

Get eSIM checkout options

GET
/v1/esim/offers/{offer_id}/checkout
bird esim offers checkout-options <offer-id>
Response200
{
  "offer_id": "eof_01krdgeqcxet5s7t44vh8rt9mg",
  "one_time": {
    "offer_revision": 1,
    "price": {
      "amount": "1.00",
      "currency_code": "EUR"
    },
    "funding": {
      "tax_amount": {
        "amount": "0.21",
        "currency_code": "EUR"
      },
      "total": {
        "amount": "1.21",
        "currency_code": "EUR"
      },
      "covered": true,
      "shortfall": {
        "amount": "0",
        "currency_code": "EUR"
      }
    }
  },
  "recurrence": {
    "available": true,
    "quote": {
      "delivery_mode": "exact_period",
      "offer_revision": 1,
      "recurrence_revision": 2,
      "price": {
        "amount": "2.00",
        "currency_code": "EUR"
      },
      "model": "calendar_month",
      "interval_count": 1,
      "funding": {
        "tax_amount": {
          "amount": "0.42",
          "currency_code": "EUR"
        },
        "total": {
          "amount": "2.42",
          "currency_code": "EUR"
        },
        "covered": false,
        "shortfall": {
          "amount": "1.21",
          "currency_code": "EUR"
        }
      }
    },
    "unavailable_reason": null
  }
}

Returns published one-time terms and automatic renewal availability for a new eSIM, including tax-inclusive totals and current funding shortfalls. Automatic renewal includes its own price and cadence when an eligible mobile network is available. Availability and funding are checked again when purchasing; this read reserves no funds or package.

Parameters

offer_idstring

The offer.

Response Payload

offer_id
string
required
one_time
object
required

Published one-time price and current funding requirement. The price excludes tax; funding.total includes tax.

Show child attributes
recurrence
object
required

When available is true, quote contains the recurring terms and unavailable_reason is null. Otherwise quote is null and unavailable_reason explains why renewal is unavailable.

Show child attributes
recurrence.available
boolean
required

Whether automatic renewal is currently available for a new eSIM.

recurrence.quote
nullable object
required
Show child attributes
recurrence.unavailable_reason
nullable string
required

Related resources

Continue with the documentation, guides and examples for this topic.

Get an implementation brief