Discover available plans
Use GET /countries for countries with active local plans and GET /regions for available regional groupings. Query GET /plans with a country code such as DE or a region slug returned by the API. Fetch a specific plan with GET /plans/{id}.
List endpoints return data and nextCursor. Pass that cursor on the next request, keeping the same filters. The default page size is 25 and the maximum is 100.
Explain the plan clearly
| Field | What to communicate |
|---|---|
coverage | Countries included in the plan |
dataAmountMb | Data allowance; interpret together with isDailyPlan |
validityDays | Plan duration |
activationType | The event that starts activation |
networks, networkType | Listed networks and network technology |
fupPolicy | Any returned fair-use conditions |
priceCents, currency | Your current Akariq purchase price |
Do not promise network speeds or coverage beyond what the plan information supports. Customers need a compatible, unlocked eSIM-capable device; link them to Akariq’s compatibility guide.
Your price and your customer’s price
The API returns the Akariq price for your partner account, based on your agreed pricing configuration. Your business decides what to charge its own consumers. Their payment to you and your purchase from Akariq are separate transactions.
Amounts are integers in USD cents: 103 means USD 1.03. Do not send decimal dollar values or assume the API performs currency conversion.
Recheck before ordering
Pass the quoted API price as expectedPriceCents when ordering. If the price has changed, the API returns 409 price_changed. Fetch the plan again, decide whether to proceed under the new price, and obtain any customer approval your own checkout requires.
Plan IDs include a package and duration variant. Treat the complete ID as an identifier returned by the API; do not construct it from country names or labels. Availability and pricing can change, so avoid treating a cached catalog as an indefinite purchase guarantee.
Field details and empty values
The OpenAPI Plan schema documents every field with an illustrative example. Expand a plan endpoint’s response schema in the interactive reference to read the same definitions.
activationTypehas two values:first_installstarts validity on installation;first_networkstarts it on the first connection to a supported mobile network.dataAmountMbuses the catalog’s MB units; Akariq displays 1024 MB as 1 GB. For a daily plan, read the allowance per day together withfupPolicyrather than presenting it as the trip’s total.scopeis normallylocal,regionalorglobal. A null classification does not imply global coverage; consultcoverage.regionis a region slug, or null when there is no associated region.periodNumis the selected duration variant in days, or null for a base plan. Order with the complete returnedid.networksandnetworkTypecan be null when information is unavailable. Network technology does not guarantee speeds.- An empty
fupPolicymeans no policy text is available. It is not a promise of unlimited unrestricted data.
Schema examples are illustrations, not live prices or availability. Always use the authenticated catalog response to prepare a real order.