---
title: "Get recurring eSIM offer terms"
canonical: "https://bird.com/docs/api/reference/get-esim-offer-recurrence"
---

# Get recurring eSIM offer terms

`GET /v1/esim/offers/{offer_id}/recurrence`

Returns the published whole-package recurring price and calendar-month or fixed-day cadence. Enrollment additionally checks that the assigned eSIM mobile network supports these terms.

## Code samples

**CLI**

```sh
bird esim offers recurrence <offer-id>
```

Examples: [CLI](/docs/api/reference/get-esim-offer-recurrence.cli.md) · [MCP](/docs/api/reference/get-esim-offer-recurrence.mcp.md) · [cURL](/docs/api/reference/get-esim-offer-recurrence.curl.md)

## Example response `200`

```json
{
  "delivery_mode": "exact_period",
  "offer_id": "eof_01krdgeqcxet5s7t44vh8rt9mg",
  "model": "calendar_month",
  "price": {
    "amount": "0.00995",
    "currency_code": "USD"
  }
}
```

## Path parameters

- `offer_id` (string): The offer.

## Response body

- `delivery_mode` (string, required)

  Relationship between the paid period and package delivery.

  - `exact_period`: the package covers the accepted paid interval.
  - `recurring_top_up`: each funded period purchases a standard package. Activation, expiry, and accumulation follow that package’s terms.

  Possible values: `exact_period`, `recurring_top_up`
- `offer_id` (string, required)
- `model` (string, required)

  Billing cadence for recurring packages.

  - `calendar_month`: periods follow calendar months from the billing anchor.
  - `fixed_days`: each period lasts the stated number of 24-hour days.

  Possible values: `calendar_month`, `fixed_days`
- `interval_count` (integer, required): The number of calendar months or fixed days in each period.
- `revision` (integer, required): The recurring configuration revision to accept.
- `price` (object, required)
- `price.amount` (string, required): Decimal amount as a string, in major currency units.
- `price.currency_code` (string, required): ISO 4217 currency code.

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)