Top up an Airalo eSIM automatically when data runs low

1. Open the Airalo app and go to My eSIMs to see data usage on the eSIM; on an iPhone, Airalo's widgets (iOS only) show the same for most packages.
2. Before the trip, check the package's Additional information tab in the Airalo store: only eSIMs marked rechargeable can take a top-up later.
3. In My eSIMs, tap Top up on that eSIM and choose a top-up package; at checkout, Apply Code/Use Airmoney spends your Airmoney balance, alone or next to another payment method.
4. If the Airalo Top up button is missing, the eSIM is non-rechargeable or its network carrier has changed, and the only way back online is a new eSIM.
5. The same check repeats every day of the trip, and the 10% warning tends to arrive when you have no Wi-Fi to finish a checkout on.

Every morning while I am in Thailand, check my Airalo eSIM. If less than 1 GB is left and the package is still valid for more than two days, add the smallest top-up and use my Airmoney first.

1. 01

   Find the eSIM in use

   The agent reads list_esims and picks the eSIM for the country you are in. With two eSIMs for the same destination, it takes the one whose usage is moving and asks you if both look idle.

2. 02

   Decide whether a top-up is worth it today

   get_data_usage gives remaining data and expiry. The agent tops up only when data is under your threshold and the package still has days left; with less than a day of validity it reports instead, because Airalo cannot extend validity and a fresh package may fit better. When Airalo shows no data bar (usage_available false), it stops and says so rather than guessing.

3. 03

   Pick the package against your rule

   list_topup_packages returns what Airalo offers for this eSIM. The agent takes the smallest one by default, or the cheapest per GB if you asked for that. An empty list means the eSIM cannot be recharged, and the agent suggests a new eSIM from search_packages instead of retrying.

4. 04

   Spend Airmoney where Airalo allows it

   get_airmoney shows the balance. The agent applies it only when applies_at_checkout is true, since Airalo refuses balances under 1 USD, and never applies more than the package price.

5. 05

   Buy with your OK, then hand over checkout

   top_up_esim waits for your confirmation unless you switched that off. When Airalo wants card payment or 3-D Secure, the agent sends you the checkout link and checks the data bar again after you finish.

Thailand eSIM (es_48213): 0.8 GB of 5 GB left, valid until 2 Nov 2026.
Below your 1 GB threshold, 21 days of validity left.
Smallest top-up: Thailand 1 GB, 7 days, 2.50 USD.
Airmoney 4.30 USD available; 2.50 USD applied, nothing due.
Top-up bought after your OK, order 2026101112399.
Japan eSIM (es_47790): not rechargeable, no action.

• Airalo sends low data notifications when an eSIM reaches 25% and 10% data remaining, so a threshold of your own only adds value above or between those two points.
• Airalo's data allowance covers the whole validity period, not a daily amount: a 1 GB, 7-day package can be used up on day one.
• Airalo cannot extend the validity period of a package; a top-up adds a package to the eSIM rather than more days to the old one.
• Airalo says most eSIMs can be topped up after the data runs out or the first package expires, as long as the eSIM is rechargeable and the carrier has not changed.
• Airalo Airmoney can pay part of a top-up, but a balance under 1.00 USD cannot be applied at checkout, and Airmoney cannot pay for Renewals.

top_up_esim asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: Airalo Help: How can I top up an eSIM? · Airalo Help: How do data amounts and validity periods work? · Airalo Help: Why is my top-up package not activating? · Airalo Help: What is Airmoney?

curl https://cotlet.dev/api/v1/airalo/top_up_esim \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"esim_id":"es_48213","package_id":"th-topup-1gb-7d","airmoney_usd":2.5}'

{
  "esim_id": "es_48213",
  "order_id": "2026101112399",
  "package": "Thailand 3 GB, 30 days",
  "price_usd": 6.5,
  "airmoney_applied_usd": 2.4,
  "due_usd": 4.1,
  "status": "checkout_required",
  "checkout_url": "https://example.com/checkout/2026101112399"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is airalo_top_up_esim. Example data.

• Turn off Airalo eSIM renewals after a trip
• Request an Airalo eSIM refund for a wrong purchase
• Airalo API and MCP server: every tool
• All use cases