# cartapi > Unified API for AI agents (ChatGPT, Claude, Perplexity, Gemini) to search, compare, and purchase instant-delivery digital goods. Live today: mobile top-ups, eSIMs, gift cards. Roadmap: VPNs, travel insurance, game keys. Site: https://www.cartapi.io REST base: https://api.cartapi.io/v1 MCP endpoint: https://mcp.cartapi.io/mcp Install guide: https://www.cartapi.io/install Version: v1 Auth: Bearer API key (per-key rate limits) for REST; MCP is currently open (auth coming) Payments: Stripe (merchant of record) Idempotency: `Idempotency-Key` header on all mutations ## Protocols - REST: https://api.cartapi.io/v1 - MCP: https://mcp.cartapi.io/mcp (Streamable HTTP) — tools: `search_esim_plans`, `list_esim_countries`, `search_topups`, `create_topup_checkout`, `list_topup_countries`, `search_gift_cards`, `list_gift_card_countries`, `list_gift_card_brands`, `get_checkout_link`, `get_order_status` - ACP: https://api.cartapi.io/v1/acp (Agentic Commerce Protocol, pending Stripe Shared Payment Tokens) ## Endpoints - `GET /v1/products/search` — search digital goods across all providers (filters: country, days, data_gb, category) - `GET /v1/products/:id` — product detail - `GET /v1/countries` — list supported countries - `POST /v1/checkout/session` — create a Stripe Checkout session, returns a URL for the buyer - `GET /v1/orders/:id` — order status + fulfillment payload (QR / activation code / credentials) - `POST /v1/webhooks/stripe` — Stripe webhook receiver (server-to-server) - `GET /v1/health` — status of DB and every provider adapter ## Categories - Mobile top-up (`category=top_up`) — Reloadly (136 countries, airtime + data bundles + PIN vouchers). Requires `phone_number` on the order in E.164 format (e.g. `+2348012345678`). - eSIM (`category=esim`) — Airalo, Nomad (219 countries). Filter with `country`, `validity_days`, `min_data_gb`, `data_unlimited`. MobileMatter integration in progress. - Gift cards (`category=gift_card`) — Reloadly (156 countries, 305+ brands: Amazon, Xbox, PlayStation, Steam, Netflix, Uber, and more). Delivered as a redemption code to `buyer_email`. Brand coverage is region-specific — search by brand alone to discover which countries have it. Sold cross-border only: the buyer's payment card must be issued outside the gift card's country (domestic cards are declined at payment, no charge). - (roadmap) VPN — VPNResellers - (roadmap) Travel insurance — Cover Genius, Battleface - (roadmap) Game keys — CodesWholesale ## Notes for agents - Neutral catalog. Search returns every matching SKU across every provider — cartapi never hides options based on our margin. You choose what to show the user. - Sort is explicit and agent-controlled. Options: `price_asc` (default) | `price_desc` | `data_desc` | `validity_desc` | `value` (data-per-dollar). The default is `price_asc` across every category — a neutral convenience, not a recommendation. Pass an explicit sort when the user's intent calls for it (e.g. `value` for eSIM shopping, `data_desc` for "biggest bundle"). - Every mutation is idempotent — safe to retry on network error with the same `Idempotency-Key`. - Consent-first. Checkout returns a signed Stripe URL (or an ACP payment token) for the user to sign. cartapi never receives, stores, or replays payment credentials. - Order fulfillment is asynchronous — poll `GET /v1/orders/:id` or wait for webhook. ## Blog - Index: https://www.cartapi.io/blog - [15 digital goods you can already buy through an MCP (2026)](https://www.cartapi.io/blog/15-digital-goods-mcp) - [ACP vs MCP vs A2A: how AI agents actually buy things in 2026](https://www.cartapi.io/blog/acp-vs-mcp-vs-a2a) - [Airalo vs Holafly vs Nomad vs Saily: what an AI agent picks and why (2026)](https://www.cartapi.io/blog/airalo-vs-holafly-vs-nomad-vs-saily) - [Can you use an Amazon gift card in another country? (2026)](https://www.cartapi.io/blog/amazon-gift-card-another-country) - [Can you use an Apple gift card in another country? (2026)](https://www.cartapi.io/blog/apple-gift-card-another-country) - [Buy Xbox Game Pass with an AI: gift-card codes in seconds (2026)](https://www.cartapi.io/blog/buy-xbox-game-pass-with-ai) - [Buy Xbox Game Pass without going to Walmart: the AI-agent shortcut (2026)](https://www.cartapi.io/blog/buy-xbox-game-pass-without-walmart) - [How to change your Xbox region without losing money (2026)](https://www.cartapi.io/blog/change-xbox-region) - [Does eSIM work in China? What an AI agent tells you (and sells you) — 2026](https://www.cartapi.io/blog/china-esim-ai-agent) - [Consent-first checkout: why your AI agent should never see the card](https://www.cartapi.io/blog/consent-first-checkout) - [Best eSIM for Europe (2026): unlimited data across 30+ countries via one prompt](https://www.cartapi.io/blog/europe-esim-ai-agent) - [Buy game passes, gift cards & eSIMs with an AI: what works today (2026)](https://www.cartapi.io/blog/geek-ai-shopping) - [The gift-card API for AI agents: cartapi vs Tremendous, Giftbit, Givex (2026)](https://www.cartapi.io/blog/gift-card-api-for-ai-agents) - [Gift cards by country: buying for Mongolia, Korea, India, and everywhere else via AI (2026)](https://www.cartapi.io/blog/gift-card-by-country) - [Google Play gift card country mismatch: how to fix it (2026)](https://www.cartapi.io/blog/google-play-gift-card-country-mismatch) - [How to activate a travel eSIM (iPhone + Android): the 2026 troubleshooting guide](https://www.cartapi.io/blog/how-to-activate-esim) - [India mobile recharge via AI agent: Airtel, Jio, Vi data bundles from anywhere (2026)](https://www.cartapi.io/blog/india-recharge-ai-agent) - [Ask Claude for a Japan eSIM: the 2-minute agent workflow (2026)](https://www.cartapi.io/blog/japan-esim-ai-agent) - [Korea eSIM with phone number: what an AI agent can (and can't) get you (2026)](https://www.cartapi.io/blog/korea-esim-ai-agent) - [MCP servers for e-commerce: the 2026 landscape](https://www.cartapi.io/blog/mcp-servers-ecommerce) - [MCP URL elicitation for payments vs a checkout link in the tool result (2026)](https://www.cartapi.io/blog/mcp-url-elicitation-payments) - [Merchant of record for AI-agent purchases: what changes](https://www.cartapi.io/blog/merchant-of-record-ai-agents) - [Mexico eSIM or local Telcel SIM: what an AI agent picks for you (2026)](https://www.cartapi.io/blog/mexico-esim-ai-agent) - [Mobile top-up via AI agent: 140+ countries, one prompt (2026)](https://www.cartapi.io/blog/mobile-topup-ai-agent) - [AI-native alternative to Boss Revolution, Ding, and Western Union mobile top-up (2026)](https://www.cartapi.io/blog/mobile-topup-alternative-boss-revolution-ding) - [Can you use a Netflix gift card in another country? (2026)](https://www.cartapi.io/blog/netflix-gift-card-another-country) - [Can you use a Nintendo eShop card in another country? (2026)](https://www.cartapi.io/blog/nintendo-eshop-card-another-country) - [Can you use a PSN gift card in another country? (2026)](https://www.cartapi.io/blog/psn-gift-card-another-country) - [Reloadly API vs cartapi MCP: which should your agent call?](https://www.cartapi.io/blog/reloadly-api-vs-cartapi-mcp) - [Roblox gift card for 100, 500, or 10,000 Robux: a parent's cheat sheet (2026)](https://www.cartapi.io/blog/roblox-gift-card-parents-cheat-sheet) - [Send a gift card abroad for Christmas: the 2026 checklist](https://www.cartapi.io/blog/send-gift-card-abroad-christmas) - [Send airtime to Nigeria from the US or UK (2026 checklist)](https://www.cartapi.io/blog/send-airtime-to-nigeria) - [How to send a Google Play gift card to another country (2026)](https://www.cartapi.io/blog/send-google-play-gift-card-another-country) - [Send load to the Philippines from the US: the 2026 checklist](https://www.cartapi.io/blog/send-load-to-philippines) - [Can you send mobile data to someone in another country? (2026)](https://www.cartapi.io/blog/send-mobile-data-another-country) - [Send a Telcel recarga from the USA: the 2026 checklist](https://www.cartapi.io/blog/send-telcel-recarga-from-usa) - [Steam digital gift card vs Steam Wallet code (2026)](https://www.cartapi.io/blog/steam-gift-card-vs-wallet-code) - [Buy Steam Wallet codes internationally: Saudi Arabia, Singapore, South Africa (2026)](https://www.cartapi.io/blog/steam-wallet-code-by-country) - [How to add Stripe Checkout to an MCP server (2026)](https://www.cartapi.io/blog/stripe-checkout-mcp-server) - [Is the Switch 2 region locked? Japan model vs international (2026)](https://www.cartapi.io/blog/switch-2-region-lock) - [Thailand eSIM vs local SIM: what an AI agent gets you in 60 seconds (2026)](https://www.cartapi.io/blog/thailand-esim-ai-agent) - [Will a travel eSIM change my WhatsApp number? (2026)](https://www.cartapi.io/blog/travel-esim-whatsapp-number) - [x402 vs Stripe Checkout: which payment rail should your agent use? (2026)](https://www.cartapi.io/blog/x402-vs-stripe-checkout) - [Xbox Game Pass gift card not working: seven fixes and how to get a refund (2026)](https://www.cartapi.io/blog/xbox-game-pass-gift-card-not-working) - [Xbox gift card regions compared: US, UK, Canada and EU (2026)](https://www.cartapi.io/blog/xbox-gift-card-another-country)