// REST API reference

Get API

Designed to be called autonomously. Every endpoint returns machine-readable JSON with full OpenAPI spec.

POST /v1/sims Provision new eSIM
GET /v1/sims/{iccid} Get SIM status & usage
POST /v1/sims/{iccid}/pause Pause connectivity
POST /v1/sims/{iccid}/topup Add data allowance
GET /v1/sims/{iccid}/sessions Live session stream
DEL /v1/sims/{iccid} Terminate & reclaim
// npm install @aiagentesim/sdk
 
import { AgentESIM } from '@aiagentesim/sdk';
 
const client = new AgentESIM({
  apiKey: process.env.AIAGENTESIM_KEY
});
 
// Worldwide, no overages, never expires
const sim = await client.sims.create({
  agentId: "my-agent-001",
  coverage: "WORLDWIDE",
  dataGB: 10
});
 
sim.on('data.threshold', (e) => {
  agent.topup(e.simId);
});
# pip install aiagentesim
 
from aiagentesim import AgentESIM
 
client = AgentESIM(
  api_key=os.environ["AIAGENTESIM_KEY"]
)
 
# Worldwide, no overages, never expires
sim = client.sims.create(
  agent_id="my-agent-001",
  coverage="WORLDWIDE",
  data_gb=10
)
 
print(sim.iccid, sim.status)
# Provision a worldwide eSIM
 
curl -X POST \
  https://api.aiagentesim.com/v1/sims \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "my-agent-001",
    "coverage": "WORLDWIDE",
    "dataGB": 10
  }'