eSIM Data Store — Wholesale API

List all available eSIM plans with pricing and coverage details. Only returns plans that are not disabled, not removed from upstream, and priced for your account.

Response 200

Returns an array of PlanResponse objects:

curl -X GET https://api.esimdatastore.com/api/plans \
  -H "X-API-Key: your-api-key"

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Europe 5GB / 30 Days",
    "description": "High-speed data across 35 European countries",
    "price": "12.50",
    "duration": 30,
    "durationUnit": "DAY",
    "dataAmount": 5,
    "dataAmountUnit": "GB",
    "coverage": "Europe",
    "provisioningFee": "0.50"
  }
]

Admin only. Returns the full catalog (all plans, including disabled and upstream-removed), scoped for operator visibility rather than customer purchasability. Response shape is AdminPlanResponse[] — an operator-focused view that surfaces the plan-lifecycle flags (disabled, disabledReason, removedFromUpstream) plus the plan-sync-derived fields used by voucher batch creation (destination, compatibleTopupProductIds) and the upstream identifiers (esimfxProductId, esimfxImsiProfile, upstreamCost) that the customer-facing PlanResponse intentionally hides. Not a strict superset: PlanResponse's customer price and provisioningFee are omitted here because pricing is per-customer (customer_plan_prices) and this endpoint is customer-agnostic. Requires Authorization: Bearer $ADMIN_TOKEN.

Response 200

Returns an array of AdminPlanResponse objects. Fields beyond the customer PlanResponse:

curl -X GET https://api.esimdatastore.com/api/plans/all \
  -H "Authorization: Bearer $ADMIN_TOKEN"

Purchase an eSIM plan. The cost is deducted from your wallet balance.

Sandbox: Sandbox customers receive dummy eSIMs (ICCID prefix 89990) with no real provisioning.

Request Body

Headers

Response 201

Returns an OrderResponse object:

curl -X POST https://api.esimdatastore.com/api/orders \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{"planId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"}'

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "planId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "iccid": null,
  "operationType": "NEW",
  "status": "PENDING",
  "subscriptionStatus": "PENDING",
  "planPrice": "12.00",
  "provisioningFee": "0.50",
  "salePrice": "12.50",
  "createdAt": "2026-04-06T14:30:00.000Z"
}

Retrieve details for a specific order.

Path Parameters

Response 200

Returns an OrderResponse object (same schema as POST /orders).

curl -X GET https://api.esimdatastore.com/api/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "X-API-Key: your-api-key"

List your orders with cursor-based pagination.

Query Parameters

Response 200

Returns an array of OrderResponse objects.

curl -X GET "https://api.esimdatastore.com/api/orders?limit=10" \
  -H "X-API-Key: your-api-key"

List all eSIMs on your account.

Response 200

Returns an array of EsimListItem objects:

Note: The install QR (esimQr) is only available on the detail endpoint GET /esims/:id.

curl -X GET https://api.esimdatastore.com/api/esims \
  -H "X-API-Key: your-api-key"

[
  {
    "id": "c3d4e5f6-7890-abcd-ef12-345678901234",
    "iccid": "8901234567890123456",
    "status": "ACTIVE",
    "createdAt": "2026-04-06T14:31:00.000Z"
  }
]

Get eSIM details with live status from the eSIM provider.

Sandbox: Sandbox eSIMs always show ACTIVE status.

Path Parameters

Response 200

Returns an EsimResponse with an additional liveStatus object:

curl -X GET https://api.esimdatastore.com/api/esims/c3d4e5f6-7890-abcd-ef12-345678901234 \
  -H "X-API-Key: your-api-key"

{
  "id": "c3d4e5f6-7890-abcd-ef12-345678901234",
  "iccid": "8901234567890123456",
  "esimQr": "LPA:1$provider.example.com$ACTIVATION_CODE",
  "status": "ACTIVE",
  "createdAt": "2026-04-06T14:31:00.000Z",
  "liveStatus": {
    "iccid": "8901234567890123456",
    "esimQr": "LPA:1$provider.example.com$ACTIVATION_CODE",
    "status": "ACTIVE"
  }
}

Get data usage, activation time, and expiry for an eSIM.

Sandbox: Sandbox returns simulated usage data.

Path Parameters

Response 200

curl -X GET https://api.esimdatastore.com/api/esims/c3d4e5f6-7890-abcd-ef12-345678901234/usage \
  -H "X-API-Key: your-api-key"

{
  "iccid": "8901234567890123456",
  "usedAmount": 1250,
  "totalAmount": 5120,
  "amountUnit": "MB",
  "status": "ACTIVE",
  "activationTime": "2026-04-06T15:00:00.000Z",
  "expiry": "2026-05-06T15:00:00.000Z"
}

List available top-up plans for a specific eSIM.

Sandbox: Sandbox returns all plans with customer pricing (no upstream filter).

Path Parameters

Response 200

curl -X GET https://api.esimdatastore.com/api/esims/c3d4e5f6-7890-abcd-ef12-345678901234/topups/available \
  -H "X-API-Key: your-api-key"

[
  {
    "planId": "b2c3d4e5-f678-90ab-cdef-123456789012",
    "name": "Europe 3GB Top-Up",
    "duration": 30,
    "durationUnit": "DAY",
    "amount": 3,
    "amountUnit": "GB",
    "coverage": ["Europe"],
    "price": "8.00",
    "provisioningFee": "0.00"
  }
]

Top up an existing eSIM with additional data.

Sandbox: Sandbox top-ups simulate upstream without real provisioning.

Path Parameters

Request Body

Headers

Response 201

Returns an OrderResponse object (same schema as POST /orders, with operationType: "TOPUP").

curl -X POST https://api.esimdatastore.com/api/esims/c3d4e5f6-7890-abcd-ef12-345678901234/topup \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 770e8400-e29b-41d4-a716-446655440002" \
  -d '{"planId": "b2c3d4e5-f678-90ab-cdef-123456789012"}'

{
  "id": "d5e6f7a8-b901-2345-cdef-678901234567",
  "planId": "b2c3d4e5-f678-90ab-cdef-123456789012",
  "iccid": "8901234567890123456",
  "operationType": "TOPUP",
  "status": "PENDING",
  "subscriptionStatus": "ACTIVE",
  "planPrice": "8.00",
  "provisioningFee": "0.00",
  "salePrice": "8.00",
  "createdAt": "2026-04-06T16:00:00.000Z"
}

Get your current prepaid wallet balance.

Response 200

curl -X GET https://api.esimdatastore.com/api/wallets/balance \
  -H "X-API-Key: your-api-key"

{
  "balance": "150.00"
}

Accepts a refund request (async). Returns 202 Accepted. The wallet credit and the REFUNDED status flip commit atomically only after upstream termination succeeds. Poll GET /orders/:id until status is REFUNDED (success) or REFUND_FAILED (60-day window missed or admin-forced).

Sandbox: Sandbox refunds skip real upstream termination and commit inline.

Path Parameters

Response 202

curl -X POST https://api.esimdatastore.com/api/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/refund \
  -H "X-API-Key: your-api-key"

{
  "orderId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "REFUNDED",
  "refundRequestedAt": "2026-05-13T12:00:00.000Z",
  "refundedAt": "2026-05-13T12:00:01.234Z",
  "refundedAmount": "14.50"
}

{
  "orderId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "REFUND_PENDING",
  "refundRequestedAt": "2026-05-13T12:00:00.000Z",
  "refundedAt": null,
  "refundedAmount": null
}

# Poll GET /orders/:id every ~2s until terminal state.
for i in {1..30}; do
  STATUS=$(curl -s "$API/orders/$ORDER_ID" \
    -H "X-API-Key: $API_KEY" | jq -r .status)
  echo "poll #$i: $STATUS"
  [[ "$STATUS" == "REFUNDED" || "$STATUS" == "REFUND_FAILED" ]] && break
  sleep 2
done

Admin-only. Bypasses the upstream-termination wait and commits the wallet credit + flips the order to REFUNDED. Use this when an out-of-band signal (eSIMfx support ticket, manual termination) confirms the upstream subscription is terminated but the worker hasn't yet caught up. Requires an admin bearer token; an Idempotency-Key header is strongly recommended (see Headers below). Emits REFUND_FORCED_BY_ADMIN with the supplied reason.

Headers

• Authorization: Bearer <ADMIN_TOKEN> — required
• Idempotency-Key: <uuid> — strongly recommended. The interceptor treats a missing key as a normal one-shot call (no replay protection); when present, the admin idempotency scope is keyed by method + url + key, so retries with the same key replay the cached result and using the same key against the other admin endpoint or a different order is collision-free.

Request Body

{ "reason": "eSIMfx ticket #12345 — termination confirmed" }

reason is required, 1–500 chars. The string lands in REFUND_FORCED_BY_ADMIN as the operator's audit record.

Response 200

Same shape as POST /orders/:id/refund's response ({ orderId, status, refundRequestedAt, refundedAt, refundedAmount }) — status is REFUNDED and refundedAmount is populated.

Admin-only. Flips the order to REFUND_FAILED without crediting the wallet. Use this for confirmed duplicates, fraud, or refund requests that should never have been accepted. The customer is not credited — handle remediation out of band. Same auth + idempotency semantics as force-complete (admin bearer required; Idempotency-Key recommended but not enforced). Emits REFUND_FORCED_BY_ADMIN.

Headers

• Authorization: Bearer <ADMIN_TOKEN> — required
• Idempotency-Key: <uuid> — strongly recommended (same semantics as force-complete: missing key is a one-shot call; present key replays the cached result on retry).

Request Body

{ "reason": "confirmed duplicate refund — support ticket #4321" }

Response 200

Same shape as POST /orders/:id/refund's response — status is REFUND_FAILED and refundedAmount is null.

Generate a financial report for a given month, optionally filtered to a subset of sections, in JSON / CSV / PDF.

Headers

• Authorization: Bearer <ADMIN_TOKEN | ADMIN_REPORT_TOKEN> — required.

Query Parameters

Response 200

JSON response shape (CSV / PDF formats serialize the same fields). The revenue, revenue.daily[], and profitability.plans[] objects each carry three FIN-32 net-of-upstream-refund fields: upstreamRefundedAmount, netUpstreamCost, netMargin.

Errors

• 401 — missing or invalid bearer token (admin OR report token)
• 422 INVALID_REFERENCE — invalid month format (must be YYYY-MM), unknown sections value, or ValidationPipe rejection of the query string
• 429 — throttled (5 reports/min/IP — report generation pulls multi-month aggregates + the PDF format runs pdf-lib synchronously, so the bound is intentionally tight)
• 500 DATABASE_ERROR — uncategorized server error reached the outer wrapper: unexpected Drizzle / pg failure on a report SELECT, raw pdf-lib exception during PDF export, or CSV exporter exception. The controller wraps non-ServiceError throws so the response stays application/problem+json with code: DATABASE_ERROR.

curl -H "Authorization: Bearer $ADMIN_REPORT_TOKEN" \
  "https://api.esimdatastore.com/api/reports/financial?month=2026-03§ions=revenue,profitability"

{
  "month": "2026-03",
  "generatedAt": "2026-04-03T12:00:00.000Z",
  "revenue": {
    "grossRevenue": "40.00",
    "totalUpstreamCost": "24.00",
    "grossMargin": "16.00",
    "marginPercent": "40.00",
    "refundedAmount": "5.00",
    "refundCount": 1,
    "netRevenue": "35.00",
    "upstreamRefundedAmount": "3.00",
    "netUpstreamCost": "21.00",
    "netMargin": "14.00",
    "orderCounts": { "new": 2, "topup": 1 },
    "daily": [
      {
        "date": "2026-03-01",
        "grossRevenue": "20.00",
        "upstreamCost": "12.00",
        "grossMargin": "8.00",
        "refundedAmount": "0.00",
        "refundCount": 0,
        "orders": 1,
        "upstreamRefundedAmount": "0.00",
        "netUpstreamCost": "12.00",
        "netMargin": "8.00"
      }
    ]
  },
  "profitability": {
    "plans": [
      {
        "planId": "019db811-6b8f-70a7-96a1-f30b7bf45523",
        "planName": "EU 5GB",
        "orderCount": 3,
        "refundCount": 1,
        "grossRevenue": "40.00",
        "refundedAmount": "5.00",
        "netRevenue": "35.00",
        "grossMargin": "16.00",
        "unitMargin": "5.33",
        "upstreamRefundedAmount": "3.00",
        "netUpstreamCost": "21.00",
        "netMargin": "14.00"
      }
    ]
  }
}

Admin only. Issue an eSIM to a traveller via the Path B flow: findBySourceRef replay short-circuit → customer/plan existence checks → withAdvisoryLock per (sourceRefKind, sourceRefId) → eSIMfx createOrder('NEW', plan.esimfxProductId) → persist esims row → sign install token → esim.issued + install_token.signed audit emits → SES install email → install_email.sent on success, or install_email.failed + INSTALL_EMAIL_DELIVERY_FAILED critical event on SES throw, 10s timeout, OR QR/template render throw. No pricing or wallet path runs here — origination is upstream-issue + audit + email only. The DB partial-unique index on (source_ref_kind, source_ref_id) is the structural backstop; resignForExisting re-signs install tokens that have passed their original expiry without re-issuing the eSIM. Replay does not 409 on a different request body for the same tuple — the stored eSIM wins.

Headers

• Authorization: Bearer <ADMIN_TOKEN> — required
• Idempotency-Key: <uuid> — recommended. Combined with the DB unique on (sourceRefKind, sourceRefId) makes the call replay-safe under retries.

Request Body

Response 201

Errors

• 401 — missing or invalid admin token
• 422 — request validation failure (bad UUID, bad email shape, missing required field, enum miss on sourceRef.kind or locale) — Nest's global ValidationPipe is configured with errorHttpStatusCode: UNPROCESSABLE_ENTITY; OR business-rule violation (customer not found, plan not found) via ServiceError.invalidReference
• 429 — throttle (30/min/IP)
• 502 UPSTREAM_ERROR — three triggers, two distinct lifecycle stages. Pre-persist: (a) eSIMfx createOrder failure or 10s call-side timeout (AV-36; on timeout a UPSTREAM_TERMINATION_FAILED critical_financial event fires with state UNKNOWN message — recovery is NOT to match the sourceRef in eSIMfx admin (sourceRef is never sent upstream); instead the message provides the timeout timestamp + esimfx_product_id for a time-windowed scan against eSIMfx admin, cross-referenced with esims.esimfx_order_id to find orphans. See runbook §14 Mode D). No eSIM row exists on this branch; nothing to replay. Post-persist install-email try/catch (eSIM row + install token already in DB): (b) SES send failure or 10s timeout for the install email — INSTALL_EMAIL_DELIVERY_FAILED critical_financial event fires; (c) QRCode.toDataURL or Handlebars template render throws during install-email assembly — same INSTALL_EMAIL_DELIVERY_FAILED event fires (iter-7 fix). For (b) and (c) recovery: out-of-band delivery via POST /origination/issue with the same sourceRef + fresh Idempotency-Key returns the existing eSIM + a re-signed install URL (replay does NOT trigger SES re-send; see runbook §11.4).
• 500 DATABASE_ERROR — uncategorized server error reached the outer wrapper (unexpected Drizzle / pg failure on a SELECT or INSERT that is NOT inside the install-email try/catch). Raw QR / template / SES exceptions are caught inside that block and rethrown as 502, not 500. Operator-actionable detail is in Loki under service: ServiceErrorFilter.
• 503 — upstream circuit breaker open (EsimfxCircuitOpenFilter adds retryAfterSeconds)

curl -X POST https://api.esimdatastore.com/api/origination/issue \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 660e8400-e29b-41d4-a716-446655440099" \
  -d '{
    "customerId": "019d0001-0000-7000-8000-000000000001",
    "planId": "019d0001-0000-7000-8000-000000000010",
    "email": "[email protected]",
    "sourceRef": { "kind": "admin_order", "id": "019d0005-0000-7000-8000-00000000abcd" },
    "locale": "en",
    "expiresInDays": 90,
    "travelerName": "Traveller Name"
  }'

{
  "esimId": "019d0007-3a20-71b0-8c12-7e0a1b2c3d4e",
  "installToken": "eyJhbGciOiJFZERTQSIs...",
  "installUrl": "https://esimdatastore.com/en/install/eyJhbGciOiJFZERTQSIs..."
}

Admin only. Generate a monthly invoice PDF for a customer. Both periodStart and periodEnd are bare-date strings (YYYY-MM-DD) that must round-trip as real calendar dates. Idempotent on the (customer_id, period_start) unique index (with a 23505 catch as the race-safety fallback).

Headers

• Authorization: Bearer <ADMIN_TOKEN> — required

Request Body

Response 200

application/pdf binary — the rendered invoice (pdf-lib).

Errors

• 401 — missing or invalid admin token
• 404 — nothing billable falls in the requested window. The invoice combines three row-sources: (1) admin-flow eSIMs (source_ref_kind = admin_order or NULL for pre-Block-B legacy rows), (2) voucher lines with redeemed_at in the period (status REDEEMED or REFUNDED — a REFUNDED row still emits its positive charge here so a same-period redeem+refund is not naked-credited; the negative comes from source #3), and (3) voucher refunds with refunded_at in the period (signed negative credit-memo lines). 404 fires only when all three are empty. ServiceError.notFound('invoice', '${customerId}:${periodStart}')
• 422 INVALID_REFERENCE — multiple causes: (a) request validation failure (bad UUID, bad date shape, calendar-invalid dates like Feb 31, periodEnd <= periodStart, periodStart/periodEnd not at UTC midnight); (b) customer not found; (c) FIN-37 missing rate-card — one or more Phase 1 eSIMs in the period have no customer_plan_prices row, so the line item cannot be priced. The invoice run is aborted before any partial write; a DATA_CONSISTENCY_ERROR critical event fires with up to 25 affected esim/plan IDs. Operator must insert the missing rate-card rows (see runbook §14 DATA_CONSISTENCY_ERROR row for the diagnosis query) then re-run. Order-flow eSIMs (esims.plan_id IS NULL) are excluded from this billing path so they cannot trigger this case.
• 409 — an invoice already exists for this (customer_id, period_start) (ServiceError.conflict from 23505)
• 429 — throttle exceeded (10 invoice runs/min/IP — invoice generation is multi-join + pdf-lib)
• 502 UPSTREAM_ERROR — the NBS rate mirror (kurs.resenje.org) was unreachable, timed out, or returned an invalid payload for a Serbian buyer with no manual exchangeRate override. Operator retries with the manual-override escape hatch: fetch the current NBS rate directly and re-submit with { rateDate, rateUsdToRsd, source: "NBS_KURS" } in the request body. See design doc docs/plans/2026-07-16-invoice-rsd-nbs-rate.md §9 for the full failure-mode catalogue.
• 500 DATABASE_ERROR — uncategorized server error reached the outer wrapper. Examples: unexpected Drizzle / pg failure on a read or transaction; raw pdf-lib exception during render. The service wraps non-ServiceError throws so the response stays application/problem+json with code: DATABASE_ERROR; operator-actionable detail is in Loki under service: ServiceErrorFilter.

Window semantics: periodStart is the inclusive UTC-midnight start; periodEnd is the exclusive UTC-midnight end. For a May 2026 invoice use 2026-05-01 / 2026-06-01.

curl -X POST https://api.esimdatastore.com/api/admin/invoices/run \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"customerId": "019d0001-0000-7000-8000-000000000001", "periodStart": "2026-05-01", "periodEnd": "2026-06-01"}' \
  -o invoice.pdf

Admin only. List email addresses in the SES suppression table. The SES bounce/complaint receiver (POST /api/webhooks/ses, v2.8.0+) writes rows on hard bounces (bounceType='Permanent') and complaints; EmailSender.send() then refuses to send to any address present here (throws 409). Use this endpoint to audit or discover addresses before invoking POST /admin/email-suppressions/remove or /remove-batch.

Query Parameters

Response 200

{
  "items": [
    {
      "email": "[email protected]",
      "reason": "hard_bounce",
      "suppressedAt": "2026-07-11T04:29:26.870Z",
      "firstNotificationId": "265d09b0-2099-5fc5-9cbb-6b7cb1b33d0b"
    }
  ],
  "total": 43,
  "limit": 100,
  "offset": 0
}

Errors

• 401 — invalid or missing admin bearer token
• 422 — invalid reason, out-of-range limit/offset, or overlong pattern
• 429 — throttle (30 req/min/IP on admin endpoints)

Admin only. Remove a single email from the suppression table. Idempotent no-op if the row doesn't exist (returns 200 with deleted: false). Body-based (not URL-based) so the standard req.body.email redaction covers PII in request logs.

Request Body

Response 200

{ "emailNormalised": "[email protected]", "deleted": true }

emailNormalised echoes the trim+lowercase form that was looked up — useful when the operator pasted an address from a log line.

Errors

• 401 — invalid or missing admin bearer token
• 422 — empty, whitespace-only, or overlong email; missing field
• 429 — throttle

Admin only. Bulk-remove 1..500 emails in one call. Each entry follows the same per-entry semantics as the single endpoint. Emits one email_suppression.unsuppressed audit event per successfully-deleted row (domain-only per SEC-45).

Request Body

{
  "emails": [
    "[email protected]",
    "[email protected]"
  ]
}

Array size 1..500 (ArrayMinSize + ArrayMaxSize). Duplicates in the input are preserved in the response order — the first occurrence sees deleted: true if the row existed, subsequent duplicates see false.

Response 200

{
  "results": [
    { "emailNormalised": "[email protected]", "deleted": true },
    { "emailNormalised": "[email protected]", "deleted": true }
  ],
  "summary": { "removed": 2, "skipped": 0 }
}

Errors

• 401 — invalid or missing admin bearer token
• 422 — empty array, more than 500 entries, or per-entry validation failure (empty / whitespace / overlong)
• 429 — throttle

Public & anonymous. Resolves the Ed25519 JWT install token and returns the LPA + QR payload for one-tap activation. No Authorization header, no API key. The path parameter is the JWT itself — anyone with the URL can fetch the payload while it is valid. Response carries Cache-Control: no-store and Pragma: no-cache via InstallNoStoreMiddleware. The endpoint is read-only — fetching /install/:token does not mark the eSIM as redeemed. The status field reflects whatever esims.redeemed_at happens to be at the time of the call; no production code path currently writes redeemed_at (a traveller-facing redeem write path is a Phase 1B follow-up).

Path Parameters

Response 200

Errors

All emit application/problem+json:

• 422 INVALID_REFERENCE — JWT shape is invalid, unparseable, or fails signature verification (ServiceError.invalidReference)
• 410 GONE — JWT exp in the past, OR esims.install_token_expires_at < now(), OR underlying eSIM is EXPIRED / BLOCKED
• 404 NOT_FOUND — token verifies but the eSIM row referenced by it no longer exists
• 422 MALFORMED_ENTITY — stored eSIM row is in a state that prevents serving (esim_qr missing or not in LPA shape, or plan_id references a missing plan). Logged at warn by ServiceErrorFilter AND emits a DATA_CONSISTENCY_ERROR critical_infra event (iter-11 fix — pageable signal so ops sees the corruption proactively rather than via support complaint)
• 429 — throttle exceeded (per-IP 10/min or per-token 30/min, SHA-256 hashed)

There is no 502 path on this endpoint — GET /install/:token reads from local DB only and does not call any upstream.

# Anonymous — no auth header.
curl https://api.esimdatastore.com/api/install/eyJhbGciOiJFZERTQSIs...

{
  "status": "ready",
  "lpaString": "LPA:1$consumer.esim.example$ACT-4F2A-9B1C",
  "qrDataUri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
  "planName": "Europe 5GB / 30 Days",
  "countryName": "Europe",
  "dataAmount": "5GB",
  "validityDays": 30
}

{
  "status": "redeemed",
  "lpaString": "",
  "qrDataUri": "",
  "planName": "Europe 5GB / 30 Days",
  "countryName": "Europe",
  "dataAmount": "5GB",
  "validityDays": 30
}