eSIM API & MCP Server – simpleSIM Developer Docs
simpleSIM offers two integration methods for developers and AI agents:
MCP Server (Model Context Protocol)
A free, open endpoint that lets AI assistants like Antigravity, Claude, Cursor, VS Code Copilot and Windsurf interact directly with the simpleSIM catalog, knowledge base and ordering system.
REST API
Classic HTTP endpoints to integrate eSIM purchasing, catalog browsing and device compatibility checks into your web and mobile apps.
Requires a B2B account with API access enabled.
What is the Model Context Protocol (MCP)?
The Model Context Protocol (MCP) is an open standard, created by Anthropic,
that enables AI assistants to connect securely to external services and perform actions on behalf of users.
An MCP server exposes „tools“ – structured functions that the AI can call automatically based on the user’s request. Unlike a traditional REST API designed for human developers, an MCP server is designed for AI agents: the assistant decides which tool to call, with what parameters, based on natural language input.
The simpleSIM MCP server provides 7 tools covering the full eSIM lifecycle: browsing the catalog, checking device compatibility, searching the knowledge base, creating orders, and tracking eSIMs. It is free, requires no API key for public tools, and supports standard MCP clients (including Antigravity, Claude Desktop, Cursor, VS Code, and Windsurf).
Inhaltsverzeichnis – MCP-Server (KI)
Der simpleSIM MCP-Server ermöglicht kompatiblen KI-Clients den Zugriff auf Werkzeuge für den Katalog, die Gerätekompatibilität, die Wissensdatenbank und Bestellungen.
MCP-Endpunkt
https://simplesim.fr/wp-json/mcp/simplesim
Schnellkonfiguration
{
"mcpServers": {
"simplesim": {
"url": "https://simplesim.fr/wp-json/mcp/simplesim"
}
}
}Zugriffsmodell
Der Endpunkt ist für öffentliche und authentifizierte MCP-Clients identisch. Katalog-, Kompatibilitäts-, Wissensdatenbank- und Bestellerstellungswerkzeuge sind öffentlich verfügbar. Für die Abfrage von eSIMs und Bestellungen ist ein authentifizierter MCP-Agent erforderlich.
Authentifizierte Clients
Der Zugriff als authentifizierter MCP-Agent erfordert eine vorherige Freigabe. Wenden Sie sich an das simpleSIM-Team, um ein autorisiertes Konto anzufordern.
Authorization: Basic base64(username:application-password)List the simpleSIM catalog
Find available simpleSIM eSIM plans for a destination or travel need, including prices and plan details.
Argumente
| Parameter | Typ | Erforderlich | Standard | Beschreibung und Einschränkungen |
|---|---|---|---|---|
per_page
|
integer | Nein |
10
|
Minimum: 1Maximum: 100 |
page
|
integer | Nein |
1
|
Minimum: 1 |
search
|
string | Nein |
""
|
Maximale Länge: 100 |
Beispiel
{
"per_page": 10,
"page": 1,
"search": ""
}Create a simpleSIM order
Create an eSIM order for a selected plan and return a payment link for the customer.
Öffentliche Bestellerstellung
Öffentliche MCP-Clients können eine Bestellung ohne Kundenkonto erstellen. Die erstellte Bestellung ist eine Gastbestellung, und die zurückgegebene payment_url kann vom Kunden geöffnet werden, um die Zahlung abzuschließen.
Die öffentliche Bestellerstellung ist gegen Missbrauch und versehentliche Duplikate geschützt. Wird dieselbe Anfrage innerhalb des Deduplizierungszeitraums wiederholt, kann die vorhandene ausstehende Bestellung mit reused=true zurückgegeben werden, anstatt eine neue zu erstellen. Für eine Kunden-E-Mail-Adresse dürfen höchstens 3 ausstehende oder zurückgestellte MCP-Bestellungen vorhanden sein.
Nicht bezahlte öffentliche MCP-Bestellungen werden standardmäßig nach 1 Stunde automatisch storniert. Für die öffentliche Bestellerstellung gelten außerdem Limits pro IP-Adresse, pro E-Mail-Adresse und globale Limits.
Authentifizierte MCP-Agenten
Wenn ein authentifizierter MCP-Agent eine Bestellung erstellt, wird sie dem Konto dieses Agenten zugeordnet, anstatt als Gastbestellung erstellt zu werden. Die öffentlichen Schutzlimits gelten nicht für autorisierte MCP-Agenten.
Sichere Wiederholungsversuche
Beim Erstellen einer Bestellung kann optional idempotency_key angegeben werden. Wird derselbe Schlüssel mit denselben Bestellparametern erneut verwendet, wird die vorhandene Bestellung sicher zurückgegeben. Die Wiederverwendung mit abweichenden Parametern wird abgelehnt, um versehentliche Duplikate oder widersprüchliche Bestellungen zu verhindern.
Zahlung und Bestellzugriff
Beim Erstellen einer öffentlichen Bestellung wird nur der Zahlungslink zurückgegeben; dadurch wird kein Zugriff auf die Werkzeuge zur Abfrage von Bestellungen oder eSIMs gewährt. order-get-summary und esim-get-public bleiben authentifizierten MCP-Agenten vorbehalten und geben nur Ressourcen aus, die diesem autorisierten Client zugeordnet sind.
Argumente
| Parameter | Typ | Erforderlich | Standard | Beschreibung und Einschränkungen |
|---|---|---|---|---|
product_sku
|
string | Ja |
—
|
Mindestlänge: 1Maximale Länge: 100 |
quantity
|
integer | Nein |
1
|
Minimum: 1Maximum: 5 |
customer_email
|
string | Ja |
—
|
Mindestlänge: 3Maximale Länge: 254 |
customer_first_name
|
string | Nein |
—
|
Maximale Länge: 100 |
customer_last_name
|
string | Nein |
—
|
Maximale Länge: 100 |
note
|
string | Nein |
—
|
Maximale Länge: 500 |
device_compatibility_confirmed
|
boolean | Ja |
—
|
— |
idempotency_key
|
string | Nein |
—
|
Optional unique key used to safely retry the same order request without creating a duplicate. Mindestlänge: 16Maximale Länge: 100 |
unlimited_days
|
integer | Nein |
—
|
Number of days to purchase for an unlimited eSIM offer. Minimum: 1Maximum: 60 |
Beispiel
{
"product_sku": "FR_1_7",
"quantity": 1,
"customer_email": "customer@example.com",
"customer_first_name": "string",
"customer_last_name": "string",
"note": "string",
"device_compatibility_confirmed": true,
"idempotency_key": "order-550e8400-e29b-41d4-a716",
"unlimited_days": 1
}Check eSIM device compatibility
Check whether a phone, tablet, or other device is compatible with eSIM.
Argumente
| Parameter | Typ | Erforderlich | Standard | Beschreibung und Einschränkungen |
|---|---|---|---|---|
query
|
string | Ja |
—
|
Mindestlänge: 1Maximale Länge: 100 |
per_page
|
integer | Nein |
5
|
Minimum: 1Maximum: 50 |
page
|
integer | Nein |
1
|
Minimum: 1 |
Beispiel
{
"query": "iPhone 17",
"per_page": 5,
"page": 1
}Get the complete knowledge base
Get simpleSIM help and product information about eSIMs, ordering, activation, compatibility, and support.
Argumente
Dieses Tool akzeptiert keine Argumente.
Get eSIM fields and order summary
Check the status and available details of an eSIM, together with basic information about its order. Authorized MCP Agent access is required.
Argumente
| Parameter | Typ | Erforderlich | Standard | Beschreibung und Einschränkungen |
|---|---|---|---|---|
esim_id
|
integer | Ja |
—
|
Minimum: 1 |
Beispiel
{
"esim_id": 1
}Get order summary
Check the status and basic details of an order, including its associated eSIMs. Authorized MCP Agent access is required.
Argumente
| Parameter | Typ | Erforderlich | Standard | Beschreibung und Einschränkungen |
|---|---|---|---|---|
order_id
|
integer | Ja |
—
|
Minimum: 1 |
Beispiel
{
"order_id": 1
}MCP Usage Examples
Once the simpleSIM MCP server is configured, you can ask your AI assistant (Antigravity, Claude, Cursor, etc.) questions in plain language. The assistant will automatically select the right tool and call it with the appropriate parameters.
Example 1: Find an eSIM plan
💬 User prompt:“Find me an eSIM plan for Japan with at least 5 GB of data.“
🤖 The AI assistant automatically calls simplesim-catalog-list with search = „Japan“ and filters the results by data volume.
Example 2: Check device compatibility
💬 User prompt:“Is my iPhone 15 Pro compatible with eSIM?“
🤖 The assistant calls simplesim-device-check-compatibility with query = „iPhone 15 Pro“ and returns the confirmation.
Example 3: Create an order
💬 User prompt:“Order a Europe 5GB eSIM for john@example.com.“
🤖 The assistant calls simplesim-order-create with product_sku = „EU-30_5_30“ and customer_email = „john@example.com“, then returns the secure payment link.
Example 4: Search the knowledge base
💬 User prompt:“How do I install my eSIM on a Samsung Galaxy?“
🤖 The assistant calls simplesim-kb-search with query = „install eSIM Samsung Galaxy“ and returns the step-by-step installation guide.
simpleSIM REST API
Inhaltsverzeichnis – simpleSIM REST API
Diese Anleitung beschreibt die REST-API-Endpunkte von simpleSIM, die Entwicklern zur Verfügung stehen. Sie können Ihre API-Schlüssel unter „Mein Konto → API“ erstellen, sobald der API-Zugriff für Ihr B2B-Konto aktiviert wurde.
Basis-URL
https://simplesim.fr/de/wp-json/simplesim/v1/
Postman
Postman-CollectionAuthentifizierung
HTTP Basic Auth (CK/CS)
Ratenbegrenzungen
10 req/sec • 10,000/Tag
Inhaltstyp
application/json; charset=UTF-8
Katalog
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
per_page |
integer | Nein | 10 | Anzahl der Einträge pro Seite (1–100) |
page |
integer | Nein | 1 | Seitennummer |
search |
string | Nein | Volltextsuche |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/catalog/?per_page=10&page=1&search=France"Beispiel-Payload (JSON):
{
"per_page": 10,
"page": 1,
"search": "France"
}Beispielantwort (JSON):
{
"success": true,
"obj": {
"productsList": [
{
"product_sku": "EU-33_1_7",
"slug": "esim-europe-1gb",
"name": "eSIM Europe 1GB",
"price": 3.99,
"currency": "EUR",
"coverage_codes": [
"DE",
"AT",
"BE",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GI",
"GR",
"HU",
"IE",
"IS",
"IT",
"LV",
"LI",
"LT",
"LU",
"MT",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"SK",
"SI",
"CH",
"SE",
"CZ"
],
"data": "1",
"duration": 7,
"duration_unit": "DAY",
"validity_days": 7,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-europe-1gb/"
},
{
"product_sku": "FR_1_7",
"slug": "esim-france-1gb",
"name": "eSIM France 1GB",
"price": 3.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "1",
"duration": 7,
"duration_unit": "DAY",
"validity_days": 7,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-france-1gb/"
},
{
"product_sku": "FR_U1_1",
"slug": "esim-unlimited-france",
"name": "eSIM France Unlimited",
"price": 3.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": null,
"duration": 1,
"duration_unit": "DAY",
"validity_days": 1,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": true,
"fup_speed_label": "1 Mbps",
"unlimited_days_price": {
"1": 3.99,
"2": 6.99,
"3": 9.99,
"4": 11.99,
"5": 14.99,
"6": 17.99,
"7": 19.99,
"8": 22.99,
"9": 25.99,
"10": 28.99,
"11": 31.99,
"12": 34.99,
"13": 37.99,
"14": 39.99,
"15": 41.99,
"16": 42.99,
"17": 44.99,
"18": 45.99,
"19": 47.99,
"20": 48.99,
"21": 49.99,
"22": 50.99,
"23": 51.99,
"24": 52.99,
"25": 53.99,
"26": 54.99,
"27": 55.99,
"28": 56.99,
"29": 57.99,
"30": 59.99,
"31": 60.99,
"32": 61.99,
"33": 62.99,
"34": 63.99,
"35": 64.99,
"36": 65.99,
"37": 66.99,
"38": 67.99,
"39": 68.99,
"40": 69.99,
"41": 70.99,
"42": 71.99,
"43": 72.99,
"44": 73.99,
"45": 74.99,
"46": 75.99,
"47": 76.99,
"48": 77.99,
"49": 78.99,
"50": 79.99,
"51": 80.99,
"52": 81.99,
"53": 82.99,
"54": 83.99,
"55": 84.99,
"56": 85.99,
"57": 86.99,
"58": 87.99,
"59": 88.99,
"60": 89.99
},
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-unlimited-france/"
},
{
"product_sku": "EU-30_U1_1",
"slug": "esim-unlimited-europe",
"name": "eSIM Europe Unlimited",
"price": 4.99,
"currency": "EUR",
"coverage_codes": [
"DE",
"AT",
"BE",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GR",
"HU",
"IE",
"IS",
"IT",
"LV",
"LI",
"LT",
"LU",
"MT",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"SK",
"SI",
"CH",
"SE",
"CZ",
"TR",
"UA"
],
"data": null,
"duration": 1,
"duration_unit": "DAY",
"validity_days": 1,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": true,
"fup_speed_label": "384 Kbps",
"unlimited_days_price": {
"1": 4.99,
"2": 7.99,
"3": 10.99,
"4": 12.99,
"5": 16.99,
"6": 19.99,
"7": 21.99,
"8": 25.99,
"9": 28.99,
"10": 31.99,
"11": 34.99,
"12": 37.99,
"13": 41.99,
"14": 43.99,
"15": 45.99,
"16": 47.99,
"17": 49.99,
"18": 51.99,
"19": 53.99,
"20": 55.99,
"21": 57.99,
"22": 58.99,
"23": 60.99,
"24": 61.99,
"25": 63.99,
"26": 64.99,
"27": 66.99,
"28": 68.99,
"29": 69.99,
"30": 71.99,
"31": 73.99,
"32": 75.99,
"33": 76.99,
"34": 78.99,
"35": 79.99,
"36": 81.99,
"37": 82.99,
"38": 84.99,
"39": 86.99,
"40": 87.99,
"41": 89.99,
"42": 90.99,
"43": 92.99,
"44": 93.99,
"45": 95.99,
"46": 97.99,
"47": 98.99,
"48": 100.99,
"49": 101.99,
"50": 103.99,
"51": 104.99,
"52": 106.99,
"53": 108.99,
"54": 109.99,
"55": 111.99,
"56": 112.99,
"57": 114.99,
"58": 115.99,
"59": 117.99,
"60": 118.99
},
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-unlimited-europe/"
},
{
"product_sku": "FR_5_30",
"slug": "esim-france-5gb",
"name": "eSIM France 5GB",
"price": 9.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "5",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 5,
"link": "https://simplesim.fr/en/product/esim-france-5gb/"
},
{
"product_sku": "WW-175_1_7",
"slug": "esim-worldwide-1gb",
"name": "eSIM Worldwide 1GB",
"price": 9.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DZ",
"DE",
"AD",
"AI",
"AG",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BE",
"BY",
"BO",
"BA",
"BW",
"BN",
"BR",
"BF",
"BJ",
"KH",
"CM",
"CA",
"CV",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"DM",
"EG",
"ES",
"EE",
"SZ",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GH",
"GI",
"GD",
"GL",
"GR",
"GP",
"GT",
"GG",
"GN",
"GW",
"GF",
"GE",
"HN",
"HK",
"HU",
"IN",
"ID",
"IQ",
"IE",
"IS",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KG",
"XK",
"KW",
"LA",
"SV",
"LV",
"LB",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"MW",
"ML",
"MT",
"MA",
"MQ",
"MU",
"YT",
"MX",
"MD",
"MC",
"WW",
"MN",
"MS",
"ME",
"MZ",
"NI",
"NG",
"NO",
"NZ",
"NP",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PG",
"PY",
"NL",
"PH",
"PL",
"PF",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"RU",
"RW",
"CF",
"DO",
"RE",
"BL",
"KN",
"MF",
"VC",
"LC",
"WS",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TZ",
"TW",
"TD",
"CZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"UA",
"UY",
"VA",
"VN",
"ZM",
"ZW",
"AE",
"EC",
"US",
"IM",
"KY",
"FO",
"TC",
"VG",
"AX"
],
"data": "1",
"duration": 7,
"duration_unit": "DAY",
"validity_days": 7,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-1gb/"
},
{
"product_sku": "EU-30_5_30",
"slug": "esim-europe-5gb",
"name": "eSIM Europe 5GB",
"price": 14.99,
"currency": "EUR",
"coverage_codes": [
"AL",
"DE",
"AT",
"BE",
"BA",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GI",
"GR",
"GE",
"HU",
"IE",
"IS",
"IT",
"LV",
"LI",
"LT",
"LU",
"MK",
"MT",
"ME",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"RS",
"SK",
"SI",
"CH",
"SE",
"CZ",
"TR",
"UA"
],
"data": "5",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-europe-5gb/"
},
{
"product_sku": "FR_10_30",
"slug": "esim-france-10gb",
"name": "eSIM France 10GB",
"price": 16.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "10",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 5,
"link": "https://simplesim.fr/en/product/esim-france-10gb/"
},
{
"product_sku": "EU-30_10_30",
"slug": "esim-europe-10gb",
"name": "eSIM Europe 10GB",
"price": 19.99,
"currency": "EUR",
"coverage_codes": [
"AL",
"DE",
"AT",
"BE",
"BA",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GI",
"GR",
"GE",
"HU",
"IE",
"IS",
"IT",
"LV",
"LI",
"LT",
"LU",
"MK",
"MT",
"ME",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"RS",
"SK",
"SI",
"CH",
"SE",
"CZ",
"TR",
"UA"
],
"data": "10",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-europe-10gb/"
},
{
"product_sku": "WW-201_3_30",
"slug": "esim-worldwide-3gb",
"name": "eSIM Worldwide 3GB",
"price": 19.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DE",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BE",
"BO",
"BA",
"BW",
"BR",
"BG",
"CM",
"CA",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"EG",
"ES",
"EE",
"SZ",
"FI",
"FR",
"GA",
"GH",
"GI",
"GR",
"GU",
"GT",
"GW",
"HN",
"HK",
"HU",
"IN",
"ID",
"IE",
"IS",
"IL",
"IT",
"JP",
"JO",
"KZ",
"KE",
"KG",
"XK",
"KW",
"SV",
"LV",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"MW",
"ML",
"MT",
"MA",
"MU",
"MX",
"MD",
"MC",
"WW",
"ME",
"NI",
"NE",
"NG",
"NO",
"NZ",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PY",
"NL",
"PH",
"PL",
"PR",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"RU",
"CF",
"CG",
"RS",
"SC",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TZ",
"TW",
"TD",
"CZ",
"TH",
"TN",
"TR",
"UA",
"UY",
"VU",
"ZM",
"ZW",
"AE",
"EC",
"US"
],
"data": "3",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "3G/4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-3gb/"
},
{
"product_sku": "EU-35_20_14_VS",
"slug": "esim-europe-20gb-unlimited-calls-texts",
"name": "eSIM Europe 20GB + Calls & Texts",
"price": 24.99,
"currency": "EUR",
"coverage_codes": [
"DE",
"AD",
"AT",
"BE",
"BG",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GR",
"HU",
"IE",
"IS",
"IT",
"LV",
"LI",
"LT",
"LU",
"MT",
"MC",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"SK",
"SI",
"CH",
"SE",
"CZ",
"VA"
],
"data": "20",
"duration": 14,
"duration_unit": "DAY",
"validity_days": 14,
"validity_after_order_days": 180,
"activation_policy": "installation",
"network_tech": "4G",
"has_sms": true,
"sms_infos": "Unlimited texts in Europe",
"has_voice": true,
"voice_infos": "Unlimited calls in Europe",
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": false,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-europe-20gb-unlimited-calls-texts/"
},
{
"product_sku": "FR_20_30_VS",
"slug": "esim-france-20gb-unlimited-calls-texts",
"name": "eSIM France 20GB + Unlimited Calls & Texts",
"price": 24.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "20",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": null,
"activation_policy": "installation",
"network_tech": "4G/5G",
"has_sms": true,
"sms_infos": "Unlimited texts in Europe",
"has_voice": true,
"voice_infos": "Unlimited calls in Europe",
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": false,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-france-20gb-unlimited-calls-texts/"
},
{
"product_sku": "WW-200_5_30",
"slug": "esim-worldwide-5gb",
"name": "eSIM Worldwide 5GB",
"price": 29.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DZ",
"DE",
"AD",
"AI",
"AG",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BE",
"BY",
"BO",
"BA",
"BW",
"BN",
"BR",
"BF",
"BJ",
"KH",
"CM",
"CA",
"CV",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"DM",
"EG",
"ES",
"EE",
"SZ",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GH",
"GI",
"GD",
"GL",
"GR",
"GP",
"GT",
"GG",
"GN",
"GW",
"GF",
"GE",
"HN",
"HK",
"HU",
"IN",
"ID",
"IQ",
"IE",
"IS",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KG",
"XK",
"KW",
"LA",
"SV",
"LV",
"LB",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"MW",
"ML",
"MT",
"MA",
"MQ",
"MU",
"YT",
"MX",
"MD",
"MC",
"WW",
"MN",
"MS",
"ME",
"MZ",
"NI",
"NE",
"NG",
"NO",
"NZ",
"NP",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PG",
"PY",
"NL",
"PH",
"PL",
"PF",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"RU",
"RW",
"CF",
"DO",
"RE",
"BL",
"KN",
"MF",
"VC",
"LC",
"WS",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TJ",
"TZ",
"TW",
"TD",
"CZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"UA",
"UY",
"VA",
"VN",
"ZM",
"ZW",
"AE",
"EC",
"US",
"IM",
"KY",
"FO",
"TC",
"VG",
"AX"
],
"data": "5",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-5gb/"
},
{
"product_sku": "EU-42_50_30_VS",
"slug": "esim-europe-50gb-unlimited-calls-texts",
"name": "eSIM Europe 50GB + Calls & Texts",
"price": 39.99,
"currency": "EUR",
"coverage_codes": [
"DE",
"AD",
"AT",
"BE",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GI",
"GR",
"GG",
"HU",
"IE",
"IS",
"IT",
"JE",
"LV",
"LI",
"LT",
"LU",
"MT",
"MC",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"SK",
"SI",
"CH",
"SE",
"CZ",
"VA",
"IM",
"FO",
"AX"
],
"data": "50",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "installation",
"network_tech": "5G",
"has_sms": true,
"sms_infos": "Unlimited texts in Europe",
"has_voice": true,
"voice_infos": "Unlimited calls in Europe",
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": false,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-europe-50gb-unlimited-calls-texts/"
},
{
"product_sku": "FR_50_30_VS",
"slug": "esim-france-50gb-calls-texts",
"name": "eSIM France 50GB + Calls & Texts",
"price": 39.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "50",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "installation",
"network_tech": "4G/5G",
"has_sms": true,
"sms_infos": "Unlimited SMS within europe",
"has_voice": true,
"voice_infos": "Unlimited calls within europe",
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": false,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-france-50gb-calls-texts/"
},
{
"product_sku": "WW-177_10_30",
"slug": "esim-worldwide-10gb",
"name": "eSIM Worldwide 10GB",
"price": 49.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DZ",
"DE",
"AD",
"AI",
"AG",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BE",
"BY",
"BO",
"BA",
"BW",
"BN",
"BR",
"BF",
"BJ",
"KH",
"CM",
"CA",
"CV",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"DM",
"EG",
"ES",
"EE",
"SZ",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GH",
"GI",
"GD",
"GL",
"GR",
"GP",
"GT",
"GG",
"GN",
"GW",
"GF",
"GE",
"HN",
"HK",
"HU",
"IN",
"ID",
"IQ",
"IE",
"IS",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KG",
"XK",
"KW",
"LA",
"SV",
"LV",
"LB",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"MW",
"ML",
"MT",
"MA",
"MQ",
"MU",
"YT",
"MX",
"MD",
"MC",
"WW",
"MN",
"MS",
"ME",
"MZ",
"NI",
"NE",
"NG",
"NO",
"NZ",
"NP",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PG",
"PY",
"NL",
"PH",
"PL",
"PF",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"RU",
"RW",
"CF",
"DO",
"RE",
"BL",
"KN",
"MF",
"VC",
"LC",
"WS",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TJ",
"TZ",
"TW",
"TD",
"CZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"UA",
"UY",
"VA",
"VN",
"ZM",
"ZW",
"AE",
"EC",
"US",
"IM",
"KY",
"FO",
"TC",
"VG",
"AX"
],
"data": "10",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-10gb/"
},
{
"product_sku": "FR_50_180",
"slug": "esim-france-50gb",
"name": "eSIM France 50GB",
"price": 59.99,
"currency": "EUR",
"coverage_codes": [
"FR"
],
"data": "50",
"duration": 180,
"duration_unit": "DAY",
"validity_days": 180,
"validity_after_order_days": 180,
"activation_policy": "first_use",
"network_tech": "5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-france-50gb/"
},
{
"product_sku": "WW-177_20_30",
"slug": "esim-worldwide-20gb-30days",
"name": "eSIM Worldwide 20GB",
"price": 59.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DZ",
"DE",
"AD",
"AI",
"AG",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BE",
"BY",
"BO",
"BA",
"BW",
"BN",
"BR",
"BF",
"BJ",
"KH",
"CM",
"CA",
"CV",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"DM",
"EG",
"ES",
"EE",
"SZ",
"ET",
"FJ",
"FI",
"FR",
"GA",
"GH",
"GI",
"GD",
"GL",
"GR",
"GP",
"GT",
"GG",
"GN",
"GW",
"GF",
"GE",
"HN",
"HK",
"HU",
"IN",
"ID",
"IQ",
"IE",
"IS",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KG",
"XK",
"KW",
"LA",
"SV",
"LV",
"LB",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"MW",
"ML",
"MT",
"MA",
"MQ",
"MU",
"YT",
"MX",
"MD",
"MC",
"WW",
"MN",
"MS",
"ME",
"MZ",
"NI",
"NE",
"NG",
"NO",
"NZ",
"NP",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PG",
"PY",
"NL",
"PH",
"PL",
"PF",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"RU",
"RW",
"CF",
"DO",
"RE",
"BL",
"KN",
"MF",
"VC",
"LC",
"WS",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TJ",
"TZ",
"TW",
"TD",
"CZ",
"TH",
"TG",
"TO",
"TT",
"TN",
"TR",
"UA",
"UY",
"VA",
"VN",
"ZM",
"ZW",
"AE",
"EC",
"US",
"IM",
"KY",
"FO",
"TC",
"VG",
"AX"
],
"data": "20",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-20gb-30days/"
},
{
"product_sku": "WW-201_20_365",
"slug": "esim-worldwide-20gb",
"name": "eSIM Worldwide 20GB",
"price": 79.99,
"currency": "EUR",
"coverage_codes": [
"ZA",
"AL",
"DZ",
"DE",
"AD",
"SA",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BE",
"BY",
"BO",
"BN",
"BR",
"BG",
"KH",
"CM",
"CA",
"CL",
"CN",
"CY",
"CO",
"KR",
"CR",
"HR",
"CI",
"DK",
"EG",
"ES",
"EE",
"FJ",
"FI",
"FR",
"GH",
"GI",
"GR",
"GP",
"GT",
"GG",
"GE",
"HN",
"HK",
"HU",
"IN",
"ID",
"IE",
"IS",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KW",
"SV",
"LV",
"LR",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MY",
"ML",
"MT",
"MA",
"MX",
"MD",
"MC",
"WW",
"MN",
"ME",
"MZ",
"NI",
"NG",
"NO",
"NZ",
"OM",
"UG",
"UZ",
"PK",
"PA",
"PY",
"NL",
"PH",
"PL",
"PF",
"PR",
"PT",
"PE",
"QA",
"CD",
"RO",
"GB",
"DO",
"CG",
"RE",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"LK",
"CH",
"SE",
"SN",
"TZ",
"TW",
"CZ",
"TH",
"TT",
"TN",
"TR",
"UA",
"UY",
"VN",
"AE",
"EC",
"US",
"FO"
],
"data": "20",
"duration": 365,
"duration_unit": "DAY",
"validity_days": 365,
"validity_after_order_days": 365,
"activation_policy": "first_use",
"network_tech": "4G/5G",
"has_sms": false,
"sms_infos": null,
"has_voice": false,
"voice_infos": null,
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": true,
"topup_max_boosts": 0,
"link": "https://simplesim.fr/en/product/esim-worldwide-20gb/"
}
],
"page": 1,
"per_page": 10,
"total": 19,
"total_pages": 0,
"lang": "en"
},
"errorCode": null,
"errorMsg": null
}Produkt
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
product_sku |
string | Ja | Produkt-SKU |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/catalog/EU-42_50_30_VS/"Beispielantwort (JSON):
{
"success": true,
"obj": {
"product": {
"product_sku": "EU-42_50_30_VS",
"slug": "esim-europe-50gb-unlimited-calls-texts",
"name": "eSIM Europe 50GB + Calls & Texts",
"price": 39.99,
"currency": "EUR",
"coverage_codes": [
"DE",
"AD",
"AT",
"BE",
"BG",
"CY",
"HR",
"DK",
"ES",
"EE",
"EU",
"FI",
"FR",
"GI",
"GR",
"GG",
"HU",
"IE",
"IS",
"IT",
"JE",
"LV",
"LI",
"LT",
"LU",
"MT",
"MC",
"NO",
"NL",
"PL",
"PT",
"RO",
"GB",
"SK",
"SI",
"CH",
"SE",
"CZ",
"VA",
"IM",
"FO",
"AX"
],
"data": "50",
"duration": 30,
"duration_unit": "DAY",
"validity_days": 30,
"validity_after_order_days": 365,
"activation_policy": "installation",
"network_tech": "5G",
"has_sms": true,
"sms_infos": "Unlimited texts in Europe",
"has_voice": true,
"voice_infos": "Unlimited calls in Europe",
"tethering_allowed": true,
"is_unlimited": false,
"fup_speed_label": null,
"unlimited_days_price": null,
"topup_available": false,
"topup_max_boosts": 0
}
},
"errorCode": null,
"errorMsg": null
}Kompatible Geräte
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
per_page |
integer | Nein | 10 | Anzahl der Einträge pro Seite (1–100) |
page |
integer | Nein | 1 | Seitennummer |
search |
string | Nein | Suchmodell |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/compatible-devices/?per_page=3&page=1&search=iphone"Beispiel-Payload (JSON):
{
"per_page": 3,
"page": 1,
"search": "iphone"
}Beispielantwort (JSON):
{
"success": true,
"obj": {
"devicesList": [
{
"Name": "Apple iPhone 18 Pro Max",
"manufacturer": "Apple",
"model": "iPhone 18 Pro Max",
"release_year": null,
"comments": ""
},
{
"Name": "Apple iPhone Duo",
"manufacturer": "Apple",
"model": "iPhone Duo",
"release_year": null,
"comments": ""
},
{
"Name": "Apple iPhone 18",
"manufacturer": "Apple",
"model": "iPhone 18",
"release_year": null,
"comments": ""
}
],
"page": 1,
"per_page": 3,
"total": 41,
"total_pages": 14
},
"errorCode": null,
"errorMsg": null
}Neue Bestellung
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
products |
array | Nein | Produktliste | |
products[].product_sku |
string | Ja | Produkt-SKU | |
products[].quantity |
integer | Nein | 1 | Menge (>=1) |
products[].unlimited_days |
integer | Nein | Anzahl unbegrenzter Tage (nur für unbegrenzte Produkte) | |
products[].topup_boosts |
integer | Nein | Anzahl der Boosts (falls verfügbar) | |
products[].topup_sku |
string | Nein | Auflade-SKU | |
products[].topup_esim_id |
integer | Nein | Ziel-eSIM-ID für die Aufladung | |
note |
string | Nein | Interne Referenz, Kundeninformationen … Alles, was Sie benötigen. Sichtbar in den API-Bestelldetails und in Ihrem Konto. | |
send_processing_email |
boolean | Nein | false | E-Mail zur Bestellbestätigung senden |
send_completed_email |
boolean | Nein | false | E-Mail zur abgeschlossenen Bestellung senden (enthält eSIMs) |
completed_email_lang |
string | Nein | Sprache für abgeschlossene E-Mails. Beispiel: en, fr, es, de. | |
end_client_email |
string | Nein | E-Mail des Endkunden | |
send_end_client_email |
boolean | Nein | false | E-Mail zur Fertigstellung an den Endkunden senden |
end_client_lang |
string | Nein | Sprache für die E-Mail an den Endkunden. Beispiel: en, fr, es, de. | |
webhook_url |
string | Nein | Payload an eine Webhook-URL senden | |
testing |
boolean | Nein | false | Wenn auf true gesetzt, wird eine Mock-Nutzlast zurückgegeben, die mit dem Beispiel in der Dokumentation identisch ist (andere Parameter werden ignoriert). |
Curl:
curl -s -u "ck_key:cs_key" -H "Content-Type: application/json" -X POST 'https://simplesim.fr/de/wp-json/simplesim/v1/orders/' -d '{"products":[{"product_sku":"FR_1_7","quantity":1,"unlimited_days":0,"topup_boosts":0,"topup_sku":null,"topup_esim_id":null}],"note":"Your order note","send_processing_email":true,"send_completed_email":false,"completed_email_lang":"fr","end_client_email":"client@example.com","send_end_client_email":true,"end_client_lang":"fr","webhook_url":"https:\/\/example.com\/webhooks\/esim"}'Beispiel-Payload (JSON):
{
"products": [
{
"product_sku": "FR_1_7",
"quantity": 1,
"unlimited_days": 0,
"topup_boosts": 0,
"topup_sku": null,
"topup_esim_id": null
}
],
"note": "Your order note",
"send_processing_email": true,
"send_completed_email": false,
"completed_email_lang": "fr",
"end_client_email": "client@example.com",
"send_end_client_email": true,
"end_client_lang": "fr",
"webhook_url": "https://example.com/webhooks/esim"
}Beispielantwort (JSON):
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-10-19T20:36:57+00:00",
"currency": "EUR",
"note": "Your order note",
"completed_email_lang": "fr",
"end_client_lang": "fr",
"webhook_url": "https://example.com/webhooks/esim",
"products": [
{
"product_sku": "FR_1_7",
"name": "eSIM France 1GB",
"quantity": 1,
"unit_price": 39.99,
"line_total": 39.99,
"line_discount": 0
}
],
"esims": [
{
"id": 101,
"order_id": 0,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000000",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
}
],
"esims_count": 1,
"totals": {
"subtotal": 39.99,
"discount": 0,
"fees": [
{
"label": "Commission",
"total": -4
}
],
"fees_total": 0,
"total": 36,
"currency": "EUR"
}
}
},
"errorCode": null,
"errorMsg": null
}Bestellliste
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
per_page |
integer | Nein | 10 | Anzahl der Einträge pro Seite (1–100) Grenzwerte: Min.: 1, Max.: 100 Beispiel: 10 |
page |
integer | Nein | 1 | Seitennummer Grenzwerte: Min.: 1 Beispiel: 1 |
date_from |
string | Nein | Erstellt am/nach (UTC). Format: JJJJ-MM-TT Beispiel: 2025-01-01 |
|
date_to |
string | Nein | Erstellt am/vor (UTC). Format: JJJJ-MM-TT Beispiel: 2025-01-31 |
|
testing |
boolean | Nein | false | Wenn auf true gesetzt, wird eine Mock-Nutzlast zurückgegeben, die mit dem Beispiel in der Dokumentation identisch ist (andere Parameter werden ignoriert). Beispiel: true |
Mögliche Bestellstatus:
pending (Zahlung ausstehend), processing (In Bearbeitung), on-hold (In Wartestellung), completed (Abgeschlossen), cancelled (Storniert), refunded (Rückerstattet), failed (Fehlgeschlagen), checkout-draft (Entwurf)
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/orders/?per_page=10&page=1&date_from=2026-10-18&date_to=2026-10-19"Beispiel-Payload (JSON):
{
"per_page": 10,
"page": 1,
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}Beispielantwort (JSON):
{
"success": true,
"obj": {
"orders": [
{
"id": 8002,
"status": "completed",
"created_at": "2026-10-19T18:36:57+00:00",
"currency": "EUR",
"note": "The note added when you ordered",
"items": [
{
"product_sku": "FR_1_7",
"name": "eSIM France 1GB",
"quantity": 2,
"unit_price_ex_tax": 7,
"unit_price_inc_tax": 9,
"line_total_ex_tax": 15,
"line_total_inc_tax": 18,
"line_discount_ex_tax": 0,
"line_discount_inc_tax": 0
}
],
"esims": [
{
"id": 202,
"order_id": 8002,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000000",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
},
{
"id": 203,
"order_id": 8002,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000001",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
}
],
"esims_count": 2,
"totals": {
"subtotal_ex_tax": 15,
"subtotal_inc_tax": 18,
"tax_total": 3,
"discount_ex_tax": 0,
"discount_tax": 0,
"discount_inc_tax": 0,
"fees": [
{
"label": "Provision",
"total_ex_tax": -3.33,
"total_tax": -0.67,
"total_inc_tax": -4
}
],
"fees_total_inc_tax": -4,
"total_ex_tax": 15,
"total_inc_tax": 14,
"currency": "EUR"
}
}
],
"page": 1,
"per_page": 10,
"total": 42,
"total_pages": 5
},
"errorCode": null,
"errorMsg": null
}Bestelldetails
| Pfadparameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
id |
integer | Ja | Bestell-ID (id=0 verwenden, um die Beispielantwort zu erhalten) |
Mögliche Bestellstatus:
pending (Zahlung ausstehend), processing (In Bearbeitung), on-hold (In Wartestellung), completed (Abgeschlossen), cancelled (Storniert), refunded (Rückerstattet), failed (Fehlgeschlagen), checkout-draft (Entwurf)
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/orders/0/"Beispielantwort (JSON):
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-10-19T18:36:57+00:00",
"currency": "EUR",
"note": "The note added when you ordered",
"items": [
{
"product_sku": "FR_1_7",
"name": "eSIM France 1GB",
"quantity": 2,
"unit_price_ex_tax": 7,
"unit_price_inc_tax": 9,
"line_total_ex_tax": 15,
"line_total_inc_tax": 18,
"line_discount_ex_tax": 0,
"line_discount_inc_tax": 0
}
],
"esims": [
{
"id": 202,
"order_id": 8002,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000000",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
},
{
"id": 203,
"order_id": 8002,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000001",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
}
],
"esims_count": 2,
"totals": {
"subtotal_ex_tax": 15,
"subtotal_inc_tax": 18,
"tax_total": 3,
"discount_ex_tax": 0,
"discount_tax": 0,
"discount_inc_tax": 0,
"fees": [
{
"label": "Provision",
"total_ex_tax": -3.33,
"total_tax": -0.67,
"total_inc_tax": -4
}
],
"fees_total_inc_tax": -4,
"total_ex_tax": 15,
"total_inc_tax": 14,
"currency": "EUR"
}
}
},
"errorCode": null,
"errorMsg": null
}eSIM-Liste
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
per_page |
integer | Nein | 10 | Anzahl der Elemente pro Seite (1-100) |
page |
integer | Nein | 1 | Seitennummer |
status |
string | Nein | Nach Status filtern. Der Status ist normalerweise bekannt, kann bei bestimmten Reisezielen jedoch unbekannt bleiben (mögliche Status: null, "not_used", "in_use", "used_up", "cancelled", "expired"). | |
date_from |
string | Nein | Nach Datum filtern. Erstellt an oder nach diesem Datum. Format: YYYY-MM-DD | |
date_to |
string | Nein | Nach Datum filtern. Erstellt an oder vor diesem Datum. Format: YYYY-MM-DD | |
testing |
boolean | Nein | false | Wenn auf true gesetzt, wird eine Mock-Nutzlast zurückgegeben, die mit dem Beispiel in der Dokumentation identisch ist (andere Parameter werden ignoriert). |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/esims/?per_page=10&page=1&status=in_use&date_from=2026-10-18&date_to=2026-10-19"Beispiel-Payload (JSON):
{
"per_page": 10,
"page": 1,
"status": "in_use",
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}Beispielantwort (JSON):
{
"success": true,
"obj": {
"esims": [
{
"id": 101,
"order_id": 9001,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000001",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
},
{
"id": 102,
"order_id": 9002,
"product_sku": "FR_1_7",
"status": "used_up",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000002",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM"
}
],
"page": 1,
"per_page": 10,
"total": 42,
"total_pages": 5
},
"errorCode": null,
"errorMsg": null
}eSIM-Details
| Query-Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
id |
integer | Ja | eSIM-Beitrags-ID (numerisch). Verwende id=0 zum Testen | |
lang |
string | Nein | Optionaler Sprachcode für übersetzte eSIM-PDF-Links. Die generierte PDF-URL enthält ?lang={lang}. Beispiel: en, fr, es, de. |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/de/wp-json/simplesim/v1/esims/0/"Beispielantwort (JSON):
{
"success": true,
"obj": {
"esim": {
"id": 0,
"order_id": 0,
"product_sku": "FR_1_7",
"status": "in_use",
"ac": "LPA:1$smdpplusaddress.com$0123456789ABCDEF0123456789ABCDEF",
"msisdn": "000000000000",
"pin": "0000",
"apn_name": "apn",
"apn_user": "apnUser",
"apn_password": "apnPassword",
"note": "Zusätzliche Informationen zur eSIM",
"activation_time": "2026-10-19T20:36:57+00:00",
"duration": 30,
"available_topups": [
{
"product_sku": "TOPUP_EXAMPLE_1",
"name": "Example topup 1",
"price": 10,
"duration": 30,
"data_bytes": 1073741824
},
{
"product_sku": "TOPUP_EXAMPLE_2",
"name": "Example topup 2",
"price": 20,
"duration": 30,
"data_bytes": 5368709120
}
],
"data_percentage_used": 12.5,
"is_unlimited": false,
"links": {
"url": "https://simplesim.fr/esim/esim-1234?ac=YWJjMTIz",
"png": "https://simplesim.fr/esim/esim-1234?ac=YWJjMTIz&format=png",
"pdf": "https://simplesim.fr/esim/esim-1234?ac=YWJjMTIz&format=pdf"
}
}
},
"errorCode": null,
"errorMsg": null
}Technical Requirements & Compatibility
MCP Server Access:
The simpleSIM MCP server is public and free. No API key is required for public tools (catalog, device compatibility, knowledge base search). Simply configure the endpoint URL (https://simplesim.fr/en/wp-json/mcp/simplesim/) in your favorite MCP client such as Antigravity, Claude Desktop, Cursor, VS Code, or Windsurf.
REST API Access:
The REST API is reserved for B2B partners and registered developers.
To obtain your credentials:
- Register an account on simplesim.fr.
- Request API access activation from your account manager or support team.
- Generate your Consumer Key and Consumer Secret under My Account -> API.
Rate Limits & Data Format:
- REST API: Limited to 10 requests per second and 10,000 requests per day per account.
- Response format: All responses are returned in JSON (Content-Type: application/json; charset=UTF-8).
- Pricing & Currency: All prices are tax-inclusive and provided in USD or EUR depending on product setup.
FAQ
API keys are available for B2B customers. Create an account at simplesim.fr, request API access activation from your account manager or through our contact form, then generate your Consumer Key and Consumer Secret from My Account → API. The keys work with HTTP Basic Auth on all REST endpoints.
Yes, the simpleSIM MCP server is completely free and requires no API key. It is available at https://simplesim.fr/wp-json/simplesim-mcp/sse and can be used by any MCP-compatible client (Claude Desktop, Cursor, VS Code, Windsurf, etc.). All 7 public tools – catalog, device compatibility, knowledge base, orders and eSIM tracking – are accessible without authentication.
The simpleSIM MCP server is compatible with any client supporting the MCP protocol. This includes Antigravity, Claude Desktop (Anthropic), Cursor,
VS Code with GitHub Copilot, Windsurf (Codeium), and any custom AI agent or application built on standard MCP libraries. Configuration takes seconds: just add the server URL to your client’s configuration file.
The REST API is designed for developers integrating simpleSIM eSIMs into their own applications (websites, mobile apps, booking systems). It requires API keys and a B2B account.
The MCP server is designed for AI assistants. It lets an AI agent (like Antigravity, Claude or Cursor) interact directly with simpleSIM to browse plans, check device compatibility or create orders – all through natural language. It is free and requires no authentication for public tools.
In short: the REST API is for your applications, the MCP server is for your AI assistants.