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).
Índice – Servidor MCP (IA)
El servidor MCP de simpleSIM permite a los clientes de IA compatibles descubrir y utilizar las herramientas del catálogo, de compatibilidad, de la base de conocimientos y de pedidos.
Punto de acceso MCP
https://simplesim.fr/wp-json/mcp/simplesim
Configuración rápida
Copiar¡Copiado!
{
"mcpServers": {
"simplesim": {
"url": "https://simplesim.fr/wp-json/mcp/simplesim"
}
}
}Modelo de acceso
El endpoint es el mismo para clientes MCP públicos y autenticados. Las herramientas de catálogo, compatibilidad, base de conocimientos y creación de pedidos están disponibles públicamente. Las herramientas de consulta de eSIM y pedidos requieren un agente MCP autenticado.
Clientes autenticados
El acceso como agente MCP autenticado requiere aprobación previa. Ponte en contacto con el equipo de simpleSIM para solicitar una cuenta autorizada.
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.
Argumentos
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción y restricciones |
|---|---|---|---|---|
per_page
|
integer | No |
10
|
Mínimo: 1Máximo: 100 |
page
|
integer | No |
1
|
Mínimo: 1 |
search
|
string | No |
""
|
Longitud máxima: 100 |
Ejemplo
Copiar¡Copiado!
{
"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.
Creación pública de pedidos
Los clientes MCP públicos pueden crear un pedido sin una cuenta de cliente. El pedido creado es un pedido como invitado y el cliente puede abrir el payment_url devuelto para completar el pago.
La creación pública de pedidos está protegida frente a abusos y duplicados accidentales. Repetir la misma solicitud dentro del periodo de deduplicación puede devolver el pedido pendiente existente con reused=true en lugar de crear uno nuevo. Una dirección de correo electrónico de cliente puede tener como máximo 3 pedidos MCP pendientes o en espera.
De forma predeterminada, los pedidos MCP públicos no pagados se cancelan automáticamente después de 1 hora. La creación pública también está sujeta a límites por IP, por correo electrónico y globales.
Agentes MCP autenticados
Cuando un agente MCP autenticado crea un pedido, este se asocia a la cuenta de dicho agente en lugar de crearse como pedido de invitado. Los límites públicos contra abusos no se aplican a los agentes MCP autorizados.
Reintentos seguros
El parámetro opcional idempotency_key puede proporcionarse al crear un pedido. Reutilizar la misma clave con los mismos parámetros del pedido devuelve de forma segura el pedido existente. Si se reutiliza con parámetros diferentes, la solicitud se rechaza para evitar pedidos duplicados o incompatibles por accidente.
Pago y acceso al pedido
Crear un pedido público solo devuelve el enlace de pago; no concede acceso a las herramientas de consulta de pedidos o eSIM. order-get-summary y esim-get-public siguen estando restringidos a agentes MCP autenticados y solo muestran recursos asociados a ese cliente autorizado.
Argumentos
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción y restricciones |
|---|---|---|---|---|
product_sku
|
string | Sí |
—
|
Longitud mínima: 1Longitud máxima: 100 |
quantity
|
integer | No |
1
|
Mínimo: 1Máximo: 5 |
customer_email
|
string | Sí |
—
|
Longitud mínima: 3Longitud máxima: 254 |
customer_first_name
|
string | No |
—
|
Longitud máxima: 100 |
customer_last_name
|
string | No |
—
|
Longitud máxima: 100 |
note
|
string | No |
—
|
Longitud máxima: 500 |
device_compatibility_confirmed
|
boolean | Sí |
—
|
— |
idempotency_key
|
string | No |
—
|
Optional unique key used to safely retry the same order request without creating a duplicate. Longitud mínima: 16Longitud máxima: 100 |
unlimited_days
|
integer | No |
—
|
Number of days to purchase for an unlimited eSIM offer. Mínimo: 1Máximo: 60 |
Ejemplo
Copiar¡Copiado!
{
"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.
Argumentos
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción y restricciones |
|---|---|---|---|---|
query
|
string | Sí |
—
|
Longitud mínima: 1Longitud máxima: 100 |
per_page
|
integer | No |
5
|
Mínimo: 1Máximo: 50 |
page
|
integer | No |
1
|
Mínimo: 1 |
Ejemplo
Copiar¡Copiado!
{
"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.
Argumentos
Esta herramienta no acepta argumentos.
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.
Argumentos
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción y restricciones |
|---|---|---|---|---|
esim_id
|
integer | Sí |
—
|
Mínimo: 1 |
Ejemplo
Copiar¡Copiado!
{
"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.
Argumentos
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción y restricciones |
|---|---|---|---|---|
order_id
|
integer | Sí |
—
|
Mínimo: 1 |
Ejemplo
Copiar¡Copiado!
{
"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
Índice – API REST de simpleSIM
Esta guía describe los puntos de acceso de la API REST de simpleSIM disponibles para desarrolladores. Puede generar sus claves desde Mi cuenta → API una vez habilitado el acceso a la API en su cuenta B2B.
URL base
https://simplesim.fr/es/wp-json/simplesim/v1/
Postman
Colección PostmanAutenticación
HTTP Basic Auth (CK/CS)
Límites de tasa
10 req/sec • 10,000/día
Tipo de contenido
application/json; charset=UTF-8
Catálogo
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
per_page |
integer | No | 10 | Número de elementos por página (1–100) |
page |
integer | No | 1 | Número de página |
search |
string | No | Búsqueda de texto completo |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/catalog/?per_page=10&page=1&search=France"Ejemplo payload (JSON):
CopiarCopiado !
{
"per_page": 10,
"page": 1,
"search": "France"
}Ejemplo response (JSON):
CopiarCopiado !
{
"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
}Producto
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
product_sku |
string | Sí | SKU del producto |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/catalog/EU-42_50_30_VS/"Ejemplo response (JSON):
CopiarCopiado !
{
"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
}Dispositivos compatibles
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
per_page |
integer | No | 10 | Número de elementos por página (1–100) |
page |
integer | No | 1 | Número de página |
search |
string | No | Buscar modelo |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/compatible-devices/?per_page=3&page=1&search=iphone"Ejemplo payload (JSON):
CopiarCopiado !
{
"per_page": 3,
"page": 1,
"search": "iphone"
}Ejemplo response (JSON):
CopiarCopiado !
{
"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
}Nuevo pedido
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
products |
array | No | Lista de productos | |
products[].product_sku |
string | Sí | SKU del producto | |
products[].quantity |
integer | No | 1 | Cantidad (>=1) |
products[].unlimited_days |
integer | No | Número de días ilimitados (solo productos ilimitados) | |
products[].topup_boosts |
integer | No | Número de boosts (si están disponibles) | |
products[].topup_sku |
string | No | SKU de recarga | |
products[].topup_esim_id |
integer | No | ID de la eSIM de destino para la recarga | |
note |
string | No | Referencia interna, información del cliente… Todo lo que necesites. Visible en el detalle de pedidos de la API y en tu cuenta. | |
send_processing_email |
boolean | No | false | Enviar el correo de confirmación del pedido |
send_completed_email |
boolean | No | false | Enviar el correo de pedido completado (que contiene las eSIM) |
completed_email_lang |
string | No | Idioma utilizado para los correos completados. Ejemplo: en, fr, es, de. | |
end_client_email |
string | No | Correo del cliente final | |
send_end_client_email |
boolean | No | false | Enviar el correo de finalización al cliente final |
end_client_lang |
string | No | Idioma utilizado para el correo del cliente final. Ejemplo: en, fr, es, de. | |
webhook_url |
string | No | Recibir la carga útil en una URL de webhook | |
testing |
boolean | No | false | Si se establece en true, devuelve una carga útil ficticia idéntica al ejemplo de la documentación (los demás parámetros serán ignorados). |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" -H "Content-Type: application/json" -X POST 'https://simplesim.fr/es/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"}'Ejemplo payload (JSON):
CopiarCopiado !
{
"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"
}Ejemplo response (JSON):
CopiarCopiado !
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-10-19T20:37:51+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": "Información adicional sobre la 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
}Lista de pedidos
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
per_page |
integer | No | 10 | Número de elementos por página (1–100) Límites: mín.: 1, máx.: 100 Ejemplo: 10 |
page |
integer | No | 1 | Número de página Límites: mín.: 1 Ejemplo: 1 |
date_from |
string | No | Creado en o después de (UTC). Formato: YYYY-MM-DD Ejemplo: 2025-01-01 |
|
date_to |
string | No | Creado en o antes de (UTC). Formato: YYYY-MM-DD Ejemplo: 2025-01-31 |
|
testing |
boolean | No | false | Si se establece en true, devuelve una carga útil ficticia idéntica al ejemplo de la documentación (los demás parámetros serán ignorados). Ejemplo: true |
Estados de pedido posibles:
pending (Pendiente de pago), processing (Procesando), on-hold (En espera), completed (Completado), cancelled (Cancelado), refunded (Reembolsado), failed (Fallido), checkout-draft (Borrador)
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/orders/?per_page=10&page=1&date_from=2026-10-18&date_to=2026-10-19"Ejemplo payload (JSON):
CopiarCopiado !
{
"per_page": 10,
"page": 1,
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}Ejemplo response (JSON):
CopiarCopiado !
{
"success": true,
"obj": {
"orders": [
{
"id": 8002,
"status": "completed",
"created_at": "2026-10-19T18:37:51+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": "Información adicional sobre la 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": "Información adicional sobre la 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": "Comisión",
"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
}Detalle del pedido
| Parámetro de ruta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
id |
integer | Sí | ID del pedido (usa id=0 para obtener el payload de ejemplo) |
Estados de pedido posibles:
pending (Pendiente de pago), processing (Procesando), on-hold (En espera), completed (Completado), cancelled (Cancelado), refunded (Reembolsado), failed (Fallido), checkout-draft (Borrador)
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/orders/0/"Ejemplo response (JSON):
CopiarCopiado !
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-10-19T18:37:51+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": "Información adicional sobre la 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": "Información adicional sobre la 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": "Comisión",
"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
}Lista de eSIMs
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
per_page |
integer | No | 10 | Número de elementos por página (1-100) |
page |
integer | No | 1 | Número de página |
status |
string | No | Filtrar por estado. El estado suele conocerse, pero puede permanecer desconocido en algunos destinos (estados posibles: null, "not_used", "in_use", "used_up", "cancelled", "expired"). | |
date_from |
string | No | Filtrar por fecha. Creada en esta fecha o después. Formato: YYYY-MM-DD | |
date_to |
string | No | Filtrar por fecha. Creada en esta fecha o antes. Formato: YYYY-MM-DD | |
testing |
boolean | No | false | Si se establece en true, devuelve una carga útil ficticia idéntica al ejemplo de la documentación (los demás parámetros serán ignorados). |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/esims/?per_page=10&page=1&status=in_use&date_from=2026-10-18&date_to=2026-10-19"Ejemplo payload (JSON):
CopiarCopiado !
{
"per_page": 10,
"page": 1,
"status": "in_use",
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}Ejemplo response (JSON):
CopiarCopiado !
{
"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": "Información adicional sobre la 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": "Información adicional sobre la eSIM"
}
],
"page": 1,
"per_page": 10,
"total": 42,
"total_pages": 5
},
"errorCode": null,
"errorMsg": null
}Detalle de eSIM
| Parámetro de consulta | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
id |
integer | Sí | ID de entrada eSIM (numérico). Usa id=0 para pruebas | |
lang |
string | No | Código de idioma opcional para enlaces PDF traducidos de eSIM. La URL generada incluirá ?lang={lang}. Ejemplo: en, fr, es, de. |
Curl:
CopiarCopiado !
curl -s -u "ck_key:cs_key" "https://simplesim.fr/es/wp-json/simplesim/v1/esims/0/"Ejemplo response (JSON):
CopiarCopiado !
{
"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": "Información adicional sobre la eSIM",
"activation_time": "2026-10-19T20:37:51+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
How do I get my simpleSIM API keys?
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.
Is the simpleSIM MCP server free?
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.
Which AI assistants are compatible with the simpleSIM MCP server?
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.
What is the difference between the REST API and the MCP server?
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.