Simpal AI Commerce API

Simpal provides a public, machine-readable travel eSIM catalogue for AI agents, search systems and developers. The API allows systems to discover available destinations, inspect active eSIM plans, and recommend suitable plans.

Travel eSIM Machine-readable catalogue Merchant-controlled checkout

Direct autonomous purchasing is not currently supported. Purchases require user confirmation through Simpal's checkout flow.

Discovery manifest

Machine-readable service metadata is available at:

https://simpal.org/.well-known/agent-commerce.json

Available endpoints

Full catalogue

Returns all active Simpal travel eSIM plans available for public purchase.

https://simpal.org/api/ai/catalog.php

Countries

Returns destinations where Simpal currently has active plans.

https://simpal.org/api/ai/countries.php

Recommendation

Returns a recommended plan for a destination, trip length, traveller count and estimated usage profile.

https://simpal.org/api/ai/recommend.php?country_code=TR&days=7&usage=standard

Recommendation endpoint parameters

country_code — ISO-style destination code, for example TR, US, GB.
country — destination name. Using country_code is preferred.
days — trip duration in days.
travellers — number of travellers. Default is 1.
usage — one of light, standard, heavy, very_heavy, or hotspot.

Purchase and checkout model

The API is intended for product discovery and recommendation. It does not create orders, charge customers, store payment credentials, or trigger supplier fulfilment.

Each plan includes a checkout_url. This URL sends the customer to Simpal's merchant-controlled checkout. Payment is handled by Stripe. eSIM fulfilment occurs only after payment confirmation.

{
  "purchase_mode": "merchant_redirect",
  "direct_purchase_supported": false,
  "requires_user_confirmation": true,
  "checkout_provider": "Stripe"
}

Example recommendation response

{
  "success": true,
  "provider": "Simpal",
  "catalog_type": "travel_esim_recommendation",
  "purchase_mode": "merchant_redirect",
  "direct_purchase_supported": false,
  "recommended": {
    "country": "Turkey",
    "country_code": "TR",
    "data_gb": 10,
    "duration_days": 30,
    "price_usd": 9.99,
    "product_url": "https://simpal.org/esim/turkey-10gb-30-days",
    "checkout_url": "https://simpal.org/buy.php?packageCode=EXAMPLE"
  }
}

Policies

Support

For support, contact [email protected].

Last updated: 2026-06-08