How do I get API access?

Sign up at partners.triposim.com, select the API program, and complete the developer application. Most applications are reviewed within 24-48 hours. Once approved, you can generate sandbox API keys immediately from the dashboard.

Is there a sandbox environment for testing?

Yes. Every API partner gets sandbox keys that work with mock data. No wallet charges, no real eSIMs provisioned. The sandbox mirrors the production API exactly, so your integration code works without changes when you go live.

What authentication method does the API use?

OAuth2 client_credentials flow. Exchange your client ID and secret for a 15-minute access token. Our SDKs handle token refresh automatically. All API calls require a valid Bearer token in the Authorization header.

How are webhooks secured?

Every webhook payload is signed with HMAC-SHA256 using your webhook secret. We retry failed deliveries with exponential backoff (1min, 5min, 30min, 2hr, 12hr) for up to 24 hours. Each delivery includes an event ID for idempotent processing.

What happens if an eSIM provisioning fails?

Our multi-vendor routing engine automatically retries with a different upstream provider. If all vendors fail (extremely rare), the order is marked as failed, your wallet is not charged, and a webhook notification is sent with the failure reason.

What SDKs are available?

We provide official SDKs for JavaScript/TypeScript (npm), Python (pip), and PHP (Composer). Each SDK handles authentication, token refresh, error handling, and webhook signature verification out of the box.

Developer API

Integrate eSIM Into Your Product in Hours, Not Months

RESTful API. OAuth2. Sandbox. Webhooks. 179+ destinations. Enterprise-grade infrastructure backed by 22+ years of telecom experience.

Get API Access Read the Docs

terminal

curl -X POST https://api.triposim.com/v1/orders \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "turkey-5gb-30d",
    "quantity": 1
  }'

{
  "id": "ord_abc123",
  "status": "completed",
  "esims": [{
    "iccid": "8901234567890",
    "qr_code": "LPA:1$smdp..."
  }]
}

179+

Destinations

99.9%

Uptime SLA

< 3s

Provisioning Time

Vendors Aggregated

API Features

Built for Developers, by Developers

Every feature you need to integrate eSIM provisioning into your product reliably and securely.

OAuth2 Authentication

Industry-standard client_credentials flow. Access tokens expire after 15 minutes and are automatically refreshed by our SDKs.

Sandbox Mode

Test with mock data before going live. No wallet charges, no real eSIMs provisioned. Separate sandbox API keys.

Webhook Notifications

HMAC-SHA256 signed webhooks with exponential backoff retry. 6 event types: order.completed, esim.activated, usage.threshold, and more.

Dry-Run Orders

Validate orders without charging your wallet. Perfect for UI previews, availability checks, and price estimation before commitment.

Idempotency Keys

Prevent duplicate charges on network retries. Every create endpoint accepts an idempotency key with a 24-hour deduplication window.

Multi-Vendor Routing

5 upstream eSIM providers aggregated behind a single API. Automatic failover ensures 99.9% provisioning success rate.

Integration Flow

Five Steps to Your First eSIM

Get API Keys

Authenticate

Exchange your client credentials for a 15-minute access token via the /v1/auth/token endpoint.

Browse Catalog

Query /v1/packages with country, type, and pricing filters to find available eSIM plans.

Place Orders

POST to /v1/orders with the package ID and quantity. Receive ICCID and QR code in the response.

Deliver to Users

Show the QR code in your app or send via email. Your customer scans it to install the eSIM.

Code Examples

Get Started in Your Language

# 1. Get access token
curl -X POST https://api.triposim.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

# 2. Order an eSIM
curl -X POST https://api.triposim.com/v1/orders \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{
    "package_id": "turkey-5gb-30d",
    "quantity": 1
  }'

Endpoints

API Reference Overview

A clean, predictable REST API. Full documentation available at docs.triposim.com.

Method	Endpoint	Description
POST	/v1/auth/token	Get access token
GET	/v1/packages	Browse eSIM catalog
GET	/v1/packages/{id}	Get package details
POST	/v1/orders	Create order (provision eSIM)
GET	/v1/orders	List orders
GET	/v1/orders/{id}	Get order details
GET	/v1/esims/{iccid}	eSIM status & details
GET	/v1/esims/{iccid}/usage	Real-time data usage
GET	/v1/account/balance	Wallet balance
POST	/v1/webhooks	Register webhook endpoint
GET	/v1/health	API health check

View Full API Documentation

Use Cases

Built for Every Travel Platform

Fintech Super Apps

Add eSIM to your travel vertical alongside flights, hotels, and insurance. One-tap data connectivity for your users.

Airlines

Offer destination eSIM during the booking flow. Passengers arrive with data already provisioned on their device.

Travel Platforms

Bundle eSIM with flights and hotels. Increase average order value with a high-margin, zero-inventory add-on.

MVNOs

White-label eSIM under your brand. Full API control over provisioning, branding, and customer experience.

Corporate Travel Tools

Automate employee connectivity. Provision eSIMs based on travel itineraries, track usage, and manage expenses centrally.

Enterprise

Enterprise-Grade for Larger Partners

Processing thousands of eSIMs per month? Our enterprise tier is built for scale and reliability.

Dedicated Support

Direct Slack/Teams channel with our engineering team. Guaranteed response within 2 hours during business hours.

Custom Rate Limits

Need more than 500 orders per day? Enterprise plans support custom throughput based on your requirements.

Volume-Based Pricing

Tiered wholesale pricing that drops as your volume grows. Contact us for a custom quote above 1,000 orders per month.

SLA Guarantees

99.9% uptime SLA with financial credits for any downtime. Provisioning success rate guaranteed at 99.5% or above.

Branded Emails

Coming soon: send QR code delivery emails from your own domain with your company branding.

Priority Routing

Enterprise API partners get priority access to vendor inventory during high-demand periods.

Contact Enterprise Sales

FAQ

Frequently Asked Questions

Start Building with the TripoSIM API

From sandbox to production in hours. 179+ destinations. 5 upstream vendors. One simple API.

Get API Access Read Documentation