eSIM

Scope: esim:* (or the specific eSIM scopes issued to you). Catalog availability is controlled per tenant. If the catalog is disabled, list returns offers: [] and purchase returns 503 / catalog_disabled.

List offers

GET https://api.imbawallet.com/partner/esim-offers?country=TR&limit=50
Authorization: Bearer <access_token>

Query	Notes
`country`	Optional ISO country filter
`limit`	Page size (max 50)
`cursor`	Pagination

{
  "offers": [
    {
      "offer_id": "esim-tr-5gb-30d",
      "country": "TR",
      "title": "Turkey 5GB / 30 days",
      "data_mb": 5120,
      "validity_days": 30,
      "price_usdt": "8.50",
      "currency": "USDT"
    }
  ],
  "next_cursor": null,
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}

price_usdt is the amount debited from your settlement balance.

Purchase

POST https://api.imbawallet.com/partner/esims
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "ext_id": "esim-20260710-001",
  "offer_id": "esim-tr-5gb-30d"
}

Response `202`

{
  "ext_id": "esim-20260710-001",
  "esim_id": "019d0140-aaaa-7bbb-8ccc-111122223333",
  "offer_id": "esim-tr-5gb-30d",
  "debit_amount": "8.50",
  "debit_currency": "USDT",
  "status": "pending",
  "created_at": "2026-07-10T10:00:00.000Z",
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}

Webhook esim_purchase.status_changed includes status and ids — never LPA.
Fetch activation via GET below. Errors: catalog_disabled, unknown_offer / offer_unavailable, insufficient_balance, ext_id_conflict.

Top up

POST https://api.imbawallet.com/partner/esims/{esim_id}/topups
Content-Type: application/json

{
  "ext_id": "esim-topup-20260710-002",
  "offer_id": "esim-tr-3gb-15d"
}

Debit from settlement balance. Terminal webhook: esim_topup.status_changed (no LPA).

Get eSIM (activation + usage)

GET https://api.imbawallet.com/partner/esims/{esim_id}
Authorization: Bearer <access_token>

{
  "esim_id": "019d0140-aaaa-7bbb-8ccc-111122223333",
  "ext_id": "esim-20260710-001",
  "status": "active",
  "offer_id": "esim-tr-5gb-30d",
  "country": "TR",
  "iccid": "8999…",
  "activation": {
    "lpa": "LPA:1$…",
    "qr_available": true
  },
  "usage": {
    "data_total_mb": 5120,
    "data_used_mb": 1280,
    "data_remaining_mb": 3840,
    "valid_from": "2026-07-10T10:01:00.000Z",
    "valid_to": "2026-08-09T10:01:00.000Z",
    "as_of": "2026-07-12T08:00:00.000Z"
  },
  "created_at": "2026-07-10T10:00:00.000Z",
  "updated_at": "2026-07-12T08:00:00.000Z",
  "request_id": "019d0120-7b59-7eab-b837-a7af38ea3db2"
}

Deliver activation to your end customer yourself. Do not put LPA in logs or webhooks.

Get started

Money

Products

Operations

eSIM

eSIM

List offers

Purchase

Response `202`

Top up

Get eSIM (activation + usage)

​eSIM

​List offers

​Purchase

​Response 202

​Top up

​Get eSIM (activation + usage)

eSIM

List offers

Purchase

Response `202`

Top up

Get eSIM (activation + usage)