Tizondocs
ReferenceOffers

Retrieve an offer

GET
/v1/offers/{offer_id}

One offer, including one the provider has withdrawn (status: withdrawn), which can no longer be bought.

Authorization

ApiKey
AuthorizationBearer <token>

An account API key, sent as Authorization: Bearer tz_live_…. The prefix selects the mode: tz_test_ for sandbox, tz_live_ for real money.

In: header

Path Parameters

offer_id*string

Query Parameters

display_currency?string
Match^[A-Za-z]{3}$

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/offers/string"
{  "id": "off_jp_5gb_30d",  "object": "offer",  "category": "esim",  "name": "Japan 5GB 30 days",  "coverage": {    "type": "country",    "countries": [      "string"    ]  },  "data": {    "amount": 0,    "unit": "GB",    "unlimited": true  },  "validity_days": 0,  "price": {    "amount": 1450,    "currency": "USD"  },  "display": {    "amount": 2320000,    "currency": "NGN",    "rate": "1600.00",    "indicative": true  },  "requires_destination": true,  "status": "active"}