Developer Guide

Test the Tytanium API with our sandbox environment. No charges apply, and no real devices required.

⚠️

Sandbox Mode

All endpoints below use the sandbox environment. Data is simulated and no real eSIMs are provisioned.

Getting Started

1. Get Your Sandbox API Key

Sign in to your dashboard and navigate to the Sandbox tab. Create a new test API key.

2. Make Your First Request

All sandbox requests go to api/sandbox/v1. No charges will occur.

3. Go to Production

Switch to production API keys and change the endpoint to api/v1.

API Reference

Provision Device

Create a new device with a sandbox eSIM profile

Parameters

API_KEYstringRequired

Your sandbox API key with sk_test_ prefix

eidstringRequired

Unique device identifier (eUICC ID), 32 digits

namestringRequired

Human-readable device name

fleet_idstring

Fleet ID to assign device to (optional, uses default fleet if not provided)

Request
request.sh
curl -X POST https://api.tytanium.dev/api/sandbox/v1/devices/provision/ \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "eid": "12345678901234567890123456789012",
    "name": "Test iPhone 15",
    "fleet_id": "optional_fleet_id"
  }'
Response
200 OKapplication/json
{
  "device_id": "bqavhIbhF8gvDssnu66W",
  "esim_id": "BoqHDY3fuBtU8elootOZ",
  "iccid": "8901123495542149142",
  "activation_code": "LPA:1$testrsp.gsma.com$ENAHI85SXRFFTOAF",
  "smdp_plus_address": "testrsp.gsma.com",
  "matching_id": "ENAHI85SXRFFTOAF",
  "is_sandbox": true,
  "note": "This is a sandbox eSIM - no real cellular connectivity"
}

Next Steps

📚 Full API Docs

Explore all endpoints, webhooks, and advanced features

View Documentation →

🚀 Go to Production

Ready to deploy? Create a production API key

Open Dashboard →

💬 Get Help

Questions? Our team is here to help

Contact Support →