PikaSim
REMOTE · PIKASIM.COM · 2 COMPONENTS · SCANNED AUG 3
Anonymous eSIMs, phone numbers, and SMS codes in 190+ countries. Crypto-paid; agents self-onboard.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security63
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (purchase_esim). See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability71
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5028 tokens (~162/item across 31 items; 31 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · pikasim.com
claude mcp add --transport http com-pikasim-pikasim https://pikasim.com/mcp
[mcp_servers.com-pikasim-pikasim] url = "https://pikasim.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-pikasim-pikasim": {
"type": "remote",
"url": "https://pikasim.com/mcp",
"enabled": true
}
}
} openclaw mcp add com-pikasim-pikasim --url https://pikasim.com/mcp --transport streamable-http
mcp_servers:
com-pikasim-pikasim:
url: "https://pikasim.com/mcp" {
"mcpServers": {
"com-pikasim-pikasim": {
"type": "http",
"url": "https://pikasim.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Aug 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
- Tool “create_deposit” rewrote its description, which is the text the model reads security
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 64
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://pikasim.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=pikasim.com | CN=YE2,O=Let's Encrypt,C=US | 22 Jul 2026 | 20 Oct 2026 | ECDSA 256 | ECDSA-SHA384 | 57c20b50ae1459601ed95899a31face17bc |
| SANs: pikasim.com, www.pikasim.com | ||||||
| CN=YE2,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 4df3b15dd6c0784c507cd37b58e6f115 |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
DNSSEC insecure
Validation of pikasim.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| pikasim.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=31536000; includeSubDomains |
| x-content-type-options | nosniff |
| x-frame-options | SAMEORIGIN |
| referrer-policy | strict-origin-when-cross-origin |
| www-authenticate | Bearer resource_metadata="https://pikasim.com/.well-known/oauth-protected-resource/mcp/wallet" |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://pikasim.com/mcp | Verified | 200 | |
| http (plaintext) | http://pikasim.com/mcp | HTTPS enforced | 301 | https://pikasim.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
cancel_esim ~63
Cancel an unused eSIM and receive a refund to your wallet balance. Only works if the eSIM has not been installed or activated. Requires an agent-wallet API key (ak_live_).
| Name | Type | Req | Description |
|---|---|---|---|
| iccid | string | yes | ICCID of the eSIM to cancel |
No output schema declared.
No examples provided.
cancel_sms_rental ~129
Cancel a long-term SMS rental and refund the full amount to the wallet. Only works within 2 hours of purchase AND only if the number has NOT received any message — this mirrors the provider refund window, so if the window has passed or a code already arrived it returns a clear reason and refunds nothing (the number worked). Use for a genuine change of mind or a wrong purchase shortly after renting. The receiptId comes from rent_sms_number or list_sms_orders. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| receiptId | string | yes | The rental receipt ID from rent_sms_number or list_sms_orders |
No output schema declared.
No examples provided.
cancel_sms_verification ~71
Cancel a quick SMS order that is still waiting for a code and refund it to the wallet immediately. Refused if the SMS was already delivered (read it with check_sms_verification instead). Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| orderId | string | yes | The Order ID of the waiting quick SMS order |
No output schema declared.
No examples provided.
check_balance ~83
Returns the prepaid spending balance of the connected PikaSim agent wallet, in USD. Read-only; makes no changes. Call this before purchase_esim or purchase_phone_plan to confirm sufficient funds, or any time you need the current balance. Requires a connected agent wallet (OAuth or ak_live_ key). If no wallet is connected, the result explains how to connect one.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
check_country_coverage ~87
Check what PikaSim plans cover a country. Returns TWO buckets: DATA eSIMs (count, price range, data amounts) and PHONE-NUMBER eSIMs (count, price range — a real carrier number with voice + SMS).
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | yes | ISO 3166-1 alpha-2 country code (e.g., JP, US, DE) |
No output schema declared.
No examples provided.
check_sms_verification ~97
Poll a quick SMS order for the incoming verification code. Read-only. Call every 15-30 seconds after order_sms_verification until status is "received", then relay the code (and full message) to the user. Orders auto-refund if nothing arrives within 20 minutes. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| orderId | string | yes | The Order ID returned by order_sms_verification (also listed by list_sms_orders) |
No output schema declared.
No examples provided.
create_deposit ~268
Creates a payment invoice to add funds to the connected prepaid PikaSim Wallet, and returns a payment page link (the human can pay by card with 3D Secure, or crypto) plus per-coin crypto payment details. Accepts Bitcoin, Lightning, Monero, Zcash, USDT, and 50+ altcoins, or card on the payment page. Does not move funds itself; it returns an invoice the user pays externally, and the balance updates once the payment confirms. Use when check_balance is too low to purchase. Minimum deposit is $1 (no prepaid float required). A fully-autonomous agent holding crypto can pay WITHOUT a human: the tool returns native destinations for Lightning, Bitcoin on-chain, USDT (TRC-20/Tron), and Monero — pay the amount to any one of them. Crypto has no fee; card payments add a 2.9% processing fee on top of the credited amount. Balance is prepaid credit for purchases on PikaSim, never expires, and is not redeemable for cash. Requires a connected agent wallet (OAuth or ak_live_ key).
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount in whole US dollars to CREDIT to the wallet (minimum 1; e.g. 25 for a $25 deposit) |
No output schema declared.
No examples provided.
create_wallet ~195
Create a NEW PikaSim agent wallet for autonomous purchasing — no human, no browser, no account, no email, no KYC. Returns a wallet code + an ak_live_ API key + a small spend-only welcome credit, so you can immediately reconnect with the key (Authorization: Bearer ak_live_…) and buy an eSIM, phone number, or SMS verification number. Use this when the user has NO wallet yet and wants their agent to buy. If the user ALREADY has a wallet, do NOT create a new one — reconnect the existing wallet instead (ask them for it). You accept the Terms of Service (https://pikasim.com/tos) on the user's behalf by passing acceptTos=true.
| Name | Type | Req | Description |
|---|---|---|---|
| acceptTos | boolean | yes | Must be true: confirms the user accepts the PikaSim Terms of Service (https://pikasim.com/tos). Required to create the wallet. |
No output schema declared.
No examples provided.
extend_sms_rental ~133
Extend a long-term SMS rental so the user keeps the same number — days are ADDED on top of the current expiry. This SPENDS the wallet balance at the live tier price (the tool checks the price first and reports what was charged). Valid day options are the same duration tiers the rental was offered at. Extend BEFORE expiry; an expired rental usually cannot be recovered. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| days | number | yes | How many days to add — one of the rental's duration tiers (see list_sms_rentals for this country) |
| receiptId | string | yes | The rental receipt ID |
No output schema declared.
No examples provided.
fetch ~71
Fetch full details for one PikaSim eSIM plan by the id returned from search: coverage, data, voice/SMS allowance, duration, price, networks, and its pikasim.com purchase URL. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The plan id returned by the search tool (the packageCode) |
No output schema declared.
No examples provided.
get_esim_status ~136
Returns the live status, remaining/used data, and expiration date for one eSIM you own, looked up by its ICCID. Read-only. Use this after a purchase to track an eSIM, or whenever a user asks "how much data is left" or "is my eSIM active". The ICCID is returned by purchase_esim/purchase_phone_plan and listed by list_orders. Requires a connected agent wallet (OAuth or ak_live_ key).
| Name | Type | Req | Description |
|---|---|---|---|
| iccid | string | yes | The ICCID (the eSIM's unique serial number) returned by purchase_esim, purchase_phone_plan, or list_orders |
No output schema declared.
No examples provided.
get_package_details ~97
Get full details for a specific plan (data eSIM OR phone-number eSIM): coverage, data, voice/SMS allowance, duration, price, networks, and purchase URL. Accepts the packageCode shown in [brackets] by the search tools.
| Name | Type | Req | Description |
|---|---|---|---|
| packageCode | string | yes | Package code from a search result (e.g., CKH001 for data, change-plus-7days-1gb for a phone plan) |
No output schema declared.
No examples provided.
get_phone_plan_pricing ~85
Get the USD price and voice/SMS/data allowance for a specific PHONE-NUMBER eSIM. Accepts the packageCode from search_phone_plans.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | — | Currency code (currently only USD supported) |
| packageCode | string | yes | Phone-plan package code from search_phone_plans (e.g., change-plus-7days-1gb) |
No output schema declared.
No examples provided.
get_pricing ~66
Get the USD price for a specific plan (data eSIM OR phone-number eSIM). Accepts the packageCode from any search result.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | — | Currency code (currently only USD supported) |
| packageCode | string | yes | Package code (data or phone plan) |
No output schema declared.
No examples provided.
get_sms_rental_messages ~87
Read the inbox of a long-term SMS rental: all received messages, newest first, plus the number's status and expiry. Read-only; poll it when the user expects a message. The receiptId comes from rent_sms_number or list_sms_orders. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| receiptId | string | yes | The rental receipt ID from rent_sms_number or list_sms_orders |
No output schema declared.
No examples provided.
get_sms_service_countries ~117
List the countries offering a quick SMS verification number for one service, with live price, delivery success rate, and whether the number is a real mobile (non-VoIP) or VoIP line. Sorted by success rate — prefer high success rates, and prefer non-VoIP when the target service blocks virtual numbers. Returns each countryId in [brackets] for order_sms_verification.
| Name | Type | Req | Description |
|---|---|---|---|
| serviceId | string | yes | The serviceId from search_sms_services (e.g. "395"), or an exact service name |
No output schema declared.
No examples provided.
get_topup_options ~71
List available top-up packages for an existing eSIM, including price and data amount. Use this before topup_esim to find valid package codes. Requires an agent-wallet API key (ak_live_).
| Name | Type | Req | Description |
|---|---|---|---|
| iccid | string | yes | ICCID of the eSIM to get top-up options for |
No output schema declared.
No examples provided.
list_esims ~131
List every eSIM this wallet owns (the fleet view), newest first: ICCID, plan, order status, install link, and — for fleets of up to 8 — live remaining data inline. Read-only. Use this to answer "which eSIMs do I own / how much data is left" without already knowing an ICCID; then get_esim_status for any single eSIM's full detail. eSIMs only — SMS numbers are listed by list_sms_orders. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| page | number | — | 1-based page (50 eSIMs per page) |
No output schema declared.
No examples provided.
list_orders ~132
Returns the order history for the connected wallet, newest first: each order's ID, package, status, cost, date, ICCID, and install link. Read-only and paginated. Use this to find a past purchase, retrieve an ICCID for get_esim_status, or show a user what they have bought. Results are scoped to this wallet only. Requires a connected agent wallet (OAuth or ak_live_ key).
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Number of orders per page (default 20, maximum 50) |
| page | number | — | 1-based page number to retrieve (default 1) |
No output schema declared.
No examples provided.
list_sms_orders ~65
List this wallet's SMS orders — quick verification orders (with their Order IDs) and long-term rentals (with their receipt IDs, numbers, and expiry dates). Read-only. Use it to re-find an order ID or check what is still active. Requires a connected agent wallet.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_sms_rentals ~103
List long-term SMS RENTAL numbers: keep the same receive-only number for days to months and receive multiple SMS (fair-use 25/day). Shows each country with its rentalId, duration tiers, live prices, and LIVE STOCK per duration — skip tiers marked OUT OF STOCK. US/UK numbers are real mobile (non-VoIP); Canada is VoIP. Not allowed for banking/financial/crypto-exchange verification. Purchase with rent_sms_number.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_transactions ~98
The wallet ledger: every debit and credit (deposits, purchases, refunds) with amount, running balance, and description, newest first. Read-only and paginated; filter with type. Use this to reconcile spend or answer "where did the balance go" — check_balance only gives the current number.
| Name | Type | Req | Description |
|---|---|---|---|
| page | number | — | 1-based page (25 transactions per page) |
| type | string | — | Only show this transaction type |
No output schema declared.
No examples provided.
order_sms_verification ~193
Buy a QUICK SMS verification number: returns a temporary phone number the user enters on the target service, then the incoming code is read with check_sms_verification. This SPENDS the wallet balance (typically $0.50-$5). Single-use, valid 20 minutes, auto-refunds if no SMS arrives. Use search_sms_services and get_sms_service_countries first to pick serviceId and countryId. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| countryId | string | — | The countryId from get_sms_service_countries (defaults to United States) |
| requestId | string | — | Idempotency key: generate a fresh UUID for each NEW order, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of chargin… |
| serviceId | string | yes | The serviceId from search_sms_services |
No output schema declared.
No examples provided.
purchase_esim ~323
Purchase a DATA eSIM. Deducts from your prepaid agent wallet and returns order details with activation info (ICCID, QR code, SM-DP+). Use the packageCode from search_esim_packages. For a daily-reset "Unlimited" plan, also pass days (the number of days to buy). For phone-number eSIMs use purchase_phone_plan instead. Requires an agent-wallet API key (ak_live_).
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | — | ONLY for daily-reset "Unlimited" plans (get_package_details shows "Type: Daily unlimited"): the number of days to purchase. Valid values: 3, 5, 7, 10, 15, 30. Required for those plans, and the total… |
| packageCode | string | yes | The data-eSIM package code shown in [brackets] by search_esim_packages or get_package_details (e.g. P6ZMSDS1G). Phone-plan codes are not valid here; use purchase_phone_plan for those. |
| promoCode | string | — | Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided. |
| requestId | string | — | Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of char… |
No output schema declared.
No examples provided.
purchase_phone_plan ~316
Purchase a PHONE-NUMBER eSIM — a plan with a real carrier phone number (voice + SMS + data). Deducts from your prepaid agent wallet and returns order details with activation info (ICCID, QR code, SM-DP+). The real phone number is assigned by the carrier when the eSIM registers on the network and appears in the device settings after activation. Use the packageCode from search_phone_plans. Plans whose search result says "designated-date activation" REQUIRE activationDate. Requires an agent-wallet API key (ak_live_).
| Name | Type | Req | Description |
|---|---|---|---|
| activationDate | string | — | Activation date in YYYY-MM-DD — ONLY for plans marked "designated-date activation" in search results (e.g. the Australia phone plan), where it is REQUIRED and must be at least 2 and at most 60 days f… |
| packageCode | string | yes | Phone-plan package code (use search_phone_plans to find codes, e.g., change-plus-7days-1gb) |
| promoCode | string | — | Optional promo/discount code. Validated server-side; an invalid code rejects the order with the reason (nothing is charged). Only pass a code the user explicitly provided. |
| requestId | string | — | Idempotency key: generate a fresh UUID for each NEW purchase, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original order instead of char… |
No output schema declared.
No examples provided.
rent_sms_number ~230
Rent a LONG-TERM receive-only SMS number: the user keeps the same number for the whole rental and can receive multiple SMS (fair-use 25/day). This SPENDS the wallet balance. Use list_sms_rentals first for rentalId, valid day tiers, prices, and live stock (do not order an OUT OF STOCK tier). Extendable before expiry with extend_sms_rental, and cancellable for a full refund with cancel_sms_rental within 2 hours if no messages arrived. Not allowed for banking/financial/crypto-exchange verification. Requires a connected agent wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| days | number | yes | Rental duration in days — must be one of the duration tiers list_sms_rentals shows for this rentalId |
| rentalId | string | yes | The rentalId from list_sms_rentals (e.g. 11 for United States) |
| requestId | string | — | Idempotency key: generate a fresh UUID for each NEW rental, and reuse the SAME value when retrying after a timeout or transport error — an identical retry returns the original rental instead of charg… |
No output schema declared.
No examples provided.
search ~123
Search the PikaSim eSIM catalog (data eSIMs and phone-number eSIMs) by free-text query and/or ISO country code. Returns a list of matching plans, each with an id, a title (name + price), and a pikasim.com URL. Pass an id to the fetch tool for full details. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Free-text search, may include a country name and/or ISO 3166-1 alpha-2 code (e.g. "Japan 10GB", "US phone plan", "DE") |
No output schema declared.
No examples provided.
search_esim_packages ~185
Search PikaSim eSIM plans by country code, region, or keyword. Returns BOTH product lines in separate buckets: DATA eSIMs and PHONE-NUMBER eSIMs (real carrier number + voice + SMS). Each result shows its packageCode in [brackets] for purchasing. Use type to narrow to one line.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | — | ISO 3166-1 alpha-2 country code (e.g., JP, US, DE) |
| query | string | — | Search keyword (e.g., "Japan 10GB") |
| region | string | — | Region name (e.g., Europe, Asia, Global) |
| type | string | — | Which product line to return: "data" (data-only eSIMs), "phone" (phone-number eSIMs with voice+SMS), or "all" (both, default) |
No output schema declared.
No examples provided.
search_phone_plans ~178
Search PikaSim PHONE-NUMBER eSIMs — plans that include a REAL carrier phone number (not VoIP) with voice calls, SMS, and data. US plans give a real +1 number on AT&T and T-Mobile; local country plans cover Europe (French +33 number), Australia, Mongolia, Vietnam, and Maldives; global plans cover 157 countries. Use this when a user wants to call or text, not just data. Each result shows its packageCode in [brackets] for purchase_phone_plan.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | — | ISO 3166-1 alpha-2 country code (e.g., US for a real +1 number) |
| query | string | — | Search keyword (e.g., "US 5GB") |
| region | string | — | Region name (e.g., Global) |
No output schema declared.
No examples provided.
search_sms_services ~142
Search the SMS VERIFICATION service list — websites/apps a receive-only verification number can get a code for (Discord, Google, Telegram, ...). This is the SMS product line (no eSIM, nothing to install): the user gets a temporary phone number and reads the incoming code. Returns service names with their serviceId in [brackets]. If the target service is not listed, search "Other" — the catch-all works for any site. Next step: get_sms_service_countries.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | — | Service name to search for (e.g. "Discord", "Google", "Tinder"). Omit to list the most popular services. |
No output schema declared.
No examples provided.
topup_esim ~211
Adds more data (and on some plans voice/SMS) to an existing eSIM the user already owns, without issuing a new eSIM. This SPENDS the wallet balance and cannot be undone. First call get_topup_options with the same ICCID to get valid top-up package codes and prices, then pass one here. Use when a user wants to extend an eSIM that is running low rather than buy a new one. Requires a connected agent wallet (OAuth or ak_live_ key).
| Name | Type | Req | Description |
|---|---|---|---|
| iccid | string | yes | The ICCID of the eSIM to top up (from list_orders or a prior purchase) |
| packageCode | string | yes | A top-up package code returned by get_topup_options for this ICCID (top-up codes differ from new-purchase codes) |
| promoCode | string | — | Optional promo/discount code. Validated server-side; an invalid code rejects the top-up with the reason (nothing is charged). Only pass a code the user explicitly provided. |
No output schema declared.
No examples provided.