API eSIM & Serveur MCP – Doc Développeur simpleSIM
simpleSIM propose deux méthodes d’intégration destinées aux développeurs et aux agents IA
Serveur MCP (Model Context Protocol)
Un point d’accès gratuit et ouvert permettant aux assistants IA tels qu’Antigravity, Claude, Cursor, VS Code Copilot et Windsurf d’interagir directement avec le catalogue, la base de connaissances et le système de commande simpleSIM. Aucune clé API requise pour les outils publics.
API REST
Des points de terminaison HTTP classiques pour intégrer l’achat d’eSIM, la consultation du catalogue et la vérification de compatibilité des appareils dans vos applications web et mobiles. Nécessite un compte B2B avec accès API activé.
Qu’est-ce que le protocole MCP (Model Context Protocol)
Le Model Context Protocol (MCP) est un standard ouvert, créé par Anthropic, qui permet aux assistants IA de se connecter de manière sécurisée à des services externes et d’effectuer des actions pour le compte des utilisateurs.
Un serveur MCP expose des « outils » (tools) – des fonctions structurées que l’IA peut appeler automatiquement en fonction de la demande de l’utilisateur. Contrairement à une API REST traditionnelle conçue pour des développeurs humains, un serveur MCP est conçu pour des agents IA : l’assistant choisit lui-même l’outil à exécuter et les paramètres à transmettre à partir de requêtes en langage naturel.
Le serveur MCP simpleSIM met à disposition 6 outils couvrant l’ensemble du cycle de vie des eSIM : recherche au catalogue, test de compatibilité des smartphones, consultation de la base de connaissances, création de commandes et suivi des eSIMs. Il est gratuit, sans clé API pour les fonctions publiques, et compatible avec les clients MCP standards (Antigravity, Claude Desktop, Cursor, VS Code, Windsurf, etc.).
Sommaire – Serveur MCP (IA)
Le serveur MCP simpleSIM permet aux clients d’IA compatibles de découvrir et d’appeler les outils du catalogue, de compatibilité, de la base de connaissances et de commande.
Point de terminaison MCP
https://simplesim.fr/wp-json/mcp/simplesim
Configuration rapide
{
"mcpServers": {
"simplesim": {
"url": "https://simplesim.fr/wp-json/mcp/simplesim"
}
}
}Accès public et authentifié
Un seul point de terminaison MCP dessert les outils publics et authentifiés. Les outils publics sont directement accessibles. Utilisez votre clé MCP pour consulter les informations sur les commandes et les eSIM associées à votre compte client autorisé.
- PUBLIC : catalogue, compatibilité des appareils, base de connaissances et création de commandes invitées (si activée).
- AUTH : récapitulatifs des commandes et informations d’assistance des eSIM de votre compte client, y compris les sous-comptes B2B associés.
Obtenir et gérer votre clé MCP
- Connectez-vous à votre compte client simpleSIM. Contactez l’assistance simpleSIM pour autoriser l’accès MCP à votre compte.
- Dans les paramètres de votre compte, activez l’accès MCP et enregistrez le réglage. Gérez séparément l’activation de l’accès et la génération de la clé.
- Générez votre clé MCP et copiez-la immédiatement. La clé complète n'est affichée qu'une seule fois ; ensuite, seul un aperçu masqué est disponible.
- Configurez votre client MCP avec l’URL du point de terminaison et transmettez votre clé dans l’en-tête HTTP X-API-Key.
Utilisez la clé MCP dédiée générée dans les paramètres de votre compte. Vous pouvez la régénérer ou la révoquer depuis cette même section.
X-API-Key: YOUR_MCP_KEYExemple de configuration authentifiée — clients prenant en charge les en-têtes HTTP
{
"mcpServers": {
"simplesim": {
"url": "https://simplesim.fr/wp-json/mcp/simplesim",
"headers": {
"X-API-Key": "YOUR_MCP_KEY"
}
}
}
}Définissez l'URL du point de terminaison et l'en-tête X-API-Key dans votre client MCP. Adaptez la structure JSON ci-dessus au format de configuration utilisé par votre client.
Informations sur les commandes et les eSIM
Utilisez order_id avec simplesim-order-get-summary pour obtenir un récapitulatif de commande, ou esim_id avec simplesim-esim-get-details pour obtenir les informations d’assistance d’une eSIM.
Les réponses de recherche d’eSIM comprennent des informations d’assistance telles que le statut, la consommation, la durée de validité et les paramètres APN.
List the simpleSIM catalog
Find available simpleSIM eSIM plans for a destination or travel need, including prices and plan details.
Arguments
| Paramètre | Type | Requis | Défaut | Description et contraintes |
|---|---|---|---|---|
per_page
|
integer | Non |
10
|
Minimum : 1Maximum : 100 |
page
|
integer | Non |
1
|
Minimum : 1 |
search
|
string | Non |
""
|
Longueur maximale : 100 |
Exemple
{
"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.
Création de commande publique
Lorsque la création de commandes publiques est activée, les clients MCP publics peuvent créer une commande sans compte client. La commande WooCommerce créée est une commande invitée et le client peut ouvrir le lien payment_url renvoyé pour effectuer le paiement.
La création de commandes publiques est protégée contre les abus et les doublons accidentels. Répéter la même requête pendant la période de déduplication peut retourner la commande en attente existante avec reused=true au lieu d’en créer une nouvelle. Une adresse e-mail client peut avoir au maximum 3 commandes MCP en attente ou en attente de traitement.
Par défaut, les commandes MCP publiques non payées sont automatiquement annulées après 1 heure. La création publique est également soumise à des limites de requêtes par IP, par e-mail et globales.
Clients authentifiés
Lorsqu'un client authentifié crée une commande, celle-ci est associée à son compte client (ou au compte parent dans le cas d'un sous-compte B2B). Les limites applicables aux commandes invitées publiques ne concernent pas les clients autorisés.
Nouvelles tentatives sécurisées
Indiquez une clé idempotency_key facultative lors de la création d’une commande. Réutiliser la même clé avec les mêmes paramètres de commande renvoie la commande existante.
Paiement et accès à la commande
La création d’une commande publique renvoie un lien de paiement. Avec votre clé MCP, utilisez simplesim-order-get-summary et simplesim-esim-get-details pour obtenir des informations sur les commandes et les eSIM associées à votre compte client, y compris celles des sous-comptes B2B associés.
Arguments
| Paramètre | Type | Requis | Défaut | Description et contraintes |
|---|---|---|---|---|
product_sku
|
string | Oui |
—
|
Longueur minimale : 1Longueur maximale : 100 |
quantity
|
integer | Non |
1
|
Minimum : 1Maximum : 5 |
customer_email
|
string | Oui |
—
|
Longueur minimale : 3Longueur maximale : 254 |
customer_first_name
|
string | Non |
—
|
Longueur maximale : 100 |
customer_last_name
|
string | Non |
—
|
Longueur maximale : 100 |
note
|
string | Non |
—
|
Longueur maximale : 500 |
device_compatibility_confirmed
|
boolean | Oui |
—
|
— |
idempotency_key
|
string | Non |
—
|
Optional unique key used to safely retry the same order request without creating a duplicate. Longueur minimale : 16Longueur maximale : 100 |
unlimited_days
|
integer | Non |
—
|
Number of days to purchase for an unlimited eSIM offer. Minimum : 1Maximum : 60 |
Exemple
{
"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.
Arguments
| Paramètre | Type | Requis | Défaut | Description et contraintes |
|---|---|---|---|---|
query
|
string | Oui |
—
|
Longueur minimale : 1Longueur maximale : 100 |
per_page
|
integer | Non |
5
|
Minimum : 1Maximum : 50 |
page
|
integer | Non |
1
|
Minimum : 1 |
Exemple
{
"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.
Arguments
Cet outil n’accepte aucun argument.
Get eSIM fields and order summary
Check the status and support details of an eSIM and its order. Authentication is required. Customers can access only eSIMs belonging to their account; eligible customers can generate an MCP key in their simpleSIM account settings.
Arguments
| Paramètre | Type | Requis | Défaut | Description et contraintes |
|---|---|---|---|---|
esim_id
|
integer | Oui |
—
|
Minimum : 1 |
Exemple
{
"esim_id": 1
}Get order summary
Check the status and basic details of an order, including its associated eSIMs. Authentication is required. Customers can access only orders belonging to their account; eligible customers can generate an MCP key in their simpleSIM account settings.
Arguments
| Paramètre | Type | Requis | Défaut | Description et contraintes |
|---|---|---|---|---|
order_id
|
integer | Oui |
—
|
Minimum : 1 |
Exemple
{
"order_id": 1
}Exemples d’utilisation du serveur MCP
Une fois le serveur MCP simpleSIM configuré, vous pouvez poser des questions en langage naturel à votre assistant IA (Antigravity, Claude, Cursor, etc.). L’assistant sélectionnera automatiquement le bon outil et l’exécutera avec les paramètres appropriés.
Exemple 1 : Trouver un forfait eSIM
💬 Prompt utilisateur : « Trouve-moi un forfait eSIM pour le Japon avec au moins 5 Go de données. »
🤖 L’assistant IA appelle automatiquement simplesim-catalog-list avec search = « Japan » et filtre les résultats par volume de données.
Exemple 2 : Vérifier la compatibilité d’un appareil
💬 Prompt utilisateur : « Est-ce que mon iPhone 15 Pro est compatible eSIM ? »
🤖 L’assistant appelle simplesim-device-check-compatibility avec query = « iPhone 15 Pro » et retourne la confirmation.
Exemple 3 : Créer une commande
💬 Prompt utilisateur : « Commande une eSIM Europe 5GB pour jean@example.com. »
🤖 L’assistant appelle simplesim-order-create avec product_sku = « EU-30_5_30 » et customer_email = « jean@example.com », puis retourne le lien de paiement sécurisé.
Exemple 4 : Rechercher dans la base de connaissances
💬 Prompt utilisateur : « Comment installer mon eSIM sur un Samsung Galaxy ? »
🤖 L’assistant appelle simplesim-kb-search avec query = « installer eSIM Samsung Galaxy » et retourne le guide d’installation étape par étape.
API REST simpleSIM
Sommaire – API REST simpleSIM
Ce guide décrit les points de terminaison de l’API REST simpleSIM accessibles aux développeurs. Vous pouvez générer vos clés depuis Mon compte → API, une fois l’accès à l’API activé sur votre compte B2B.
URL de base
https://simplesim.fr/wp-json/simplesim/v1/
Postman
Collection PostmanAuthentification
HTTP Basic Auth (CK/CS)
Limites de débit
10 req/sec • 10,000/jour
Type de contenu
application/json; charset=UTF-8
Catalogue
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
per_page |
integer | Non | 10 | Nombre d'éléments par page (1-100) |
page |
integer | Non | 1 | Numéro de page |
search |
string | Non | Recherche en texte intégral |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/catalog?per_page=10&page=1&search=France"Exemple payload (JSON):
{
"per_page": 10,
"page": 1,
"search": "France"
}Exemple réponse (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_30_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": 30,
"duration_unit": "DAY",
"validity_days": 30,
"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": "GB_40_30_VS",
"slug": "esim-uk-40gb-unlimited-calls-sms",
"name": "eSIM UK 40GB + Unlimited Calls & SMS",
"price": 34.99,
"currency": "EUR",
"coverage_codes": [
"GB"
],
"data": "40",
"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 the UK",
"has_voice": true,
"voice_infos": "Unlimited calls within the UK",
"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-uk-40gb-unlimited-calls-sms/"
},
{
"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": "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-50gb-unlimited-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
}Produit
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
product_sku |
string | Oui | SKU du produit |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/catalog/EU-42_50_30_VS"Exemple réponse (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": "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
}
},
"errorCode": null,
"errorMsg": null
}Appareils compatibles
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
per_page |
integer | Non | 10 | Nombre d'éléments par page (1-100) |
page |
integer | Non | 1 | Numéro de page |
search |
string | Non | Chercher un modèle |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/compatible-devices?per_page=3&page=1&search=iphone"Exemple payload (JSON):
{
"per_page": 3,
"page": 1,
"search": "iphone"
}Exemple réponse (JSON):
{
"success": true,
"obj": {
"devicesList": [
{
"Name": "Apple iPhone 18 Pro",
"manufacturer": "Apple",
"model": "iPhone 18 Pro",
"release_year": null,
"comments": ""
},
{
"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": ""
}
],
"page": 1,
"per_page": 3,
"total": 42,
"total_pages": 14
},
"errorCode": null,
"errorMsg": null
}Nouvelle commande
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
products |
array | Non | Tableau de produits | |
products[].product_sku |
string | Oui | SKU du produit | |
products[].quantity |
integer | Non | 1 | Quantité (>=1) |
products[].unlimited_days |
integer | Non | Nombre de jours illimités (produits illimités uniquement) | |
products[].topup_boosts |
integer | Non | Nombre de boosts (si disponible) | |
products[].topup_sku |
string | Non | SKU de recharge | |
products[].topup_esim_id |
integer | Non | ID de l’eSIM cible pour la recharge | |
note |
string | Non | Référence interne, informations client… Tout ce dont vous avez besoin. Visible dans le détail des commandes de l’API et dans votre compte. | |
send_processing_email |
boolean | Non | false | Envoyer l’e-mail de confirmation de commande |
send_completed_email |
boolean | Non | false | Envoyer l’e-mail de commande terminée (contenant les eSIM) |
completed_email_lang |
string | Non | Langue utilisée pour les e-mails de commande terminée. Exemple : en, fr, es, de. | |
end_client_email |
string | Non | E-mail du client final | |
send_end_client_email |
boolean | Non | false | Envoyer l’e-mail de finalisation au client final |
end_client_lang |
string | Non | Langue utilisée pour l’e-mail du client final. Exemple : en, fr, es, de. | |
webhook_url |
string | Non | Recevoir la charge utile sur une URL de webhook | |
testing |
boolean | Non | false | Si défini sur true, retourne une charge utile fictive identique à l’exemple de la documentation (les autres paramètres seront ignorés). |
Curl:
curl -s -u "ck_key:cs_key" -H "Content-Type: application/json" -X POST 'https://simplesim.fr/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"}'Exemple 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"
}Exemple réponse (JSON):
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-11-09T09:35:30+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": "Informations complémentaires sur l'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
}Liste des commandes
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
per_page |
integer | Non | 10 | Nombre d'éléments par page (1-100) Limites : min: 1, max: 100 Exemple : 10 |
page |
integer | Non | 1 | Numéro de page Limites : min: 1 Exemple : 1 |
date_from |
string | Non | Créé le/après (UTC). Format: AAAA-MM-JJ Exemple : 2025-01-01 |
|
date_to |
string | Non | Créé le/avant (UTC). Format: AAAA-MM-JJ Exemple : 2025-01-31 |
|
testing |
boolean | Non | false | Si défini sur true, retourne une charge utile fictive identique à l’exemple de la documentation (les autres paramètres seront ignorés). Exemple : true |
Statuts de commande possibles :
pending (Attente paiement), processing (En cours), on-hold (En attente), completed (Terminée), cancelled (Annulée), refunded (Remboursée), failed (Échouée), checkout-draft (Brouillon)
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/orders?per_page=10&page=1&date_from=2026-11-08&date_to=2026-11-09"Exemple payload (JSON):
{
"per_page": 10,
"page": 1,
"date_from": "2026-11-08",
"date_to": "2026-11-09"
}Exemple réponse (JSON):
{
"success": true,
"obj": {
"orders": [
{
"id": 8002,
"status": "completed",
"created_at": "2026-11-09T07:35:30+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": "Informations complémentaires sur l'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": "Informations complémentaires sur l'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": "Commission",
"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
}Détail de la commande
| Paramètre path | Type | Requis | Défaut | Description |
|---|---|---|---|---|
id |
integer | Oui | ID Commande (id=0 pour l'exemple) |
Statuts de commande possibles :
pending (Attente paiement), processing (En cours), on-hold (En attente), completed (Terminée), cancelled (Annulée), refunded (Remboursée), failed (Échouée), checkout-draft (Brouillon)
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/orders/0"Exemple réponse (JSON):
{
"success": true,
"obj": {
"order": {
"id": 0,
"status": "completed",
"created_at": "2026-11-09T07:35:30+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": "Informations complémentaires sur l'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": "Informations complémentaires sur l'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": "Commission",
"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
}Liste des eSIMs
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
per_page |
integer | Non | 10 | Nombre d’éléments par page (1-100) |
page |
integer | Non | 1 | Numéro de page |
status |
string | Non | Filtrer par statut. Le statut est généralement connu, mais peut rester inconnu pour certaines destinations (statuts possibles : null, "not_used", "in_use", "used_up", "cancelled", "expired"). | |
date_from |
string | Non | Filtrer par date. Créée à partir de cette date incluse. Format : YYYY-MM-DD | |
date_to |
string | Non | Filtrer par date. Créée jusqu’à cette date incluse. Format : YYYY-MM-DD | |
testing |
boolean | Non | false | Si défini sur true, retourne une charge utile fictive identique à l’exemple de la documentation (les autres paramètres seront ignorés). |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/esims?per_page=10&page=1&status=in_use&date_from=2026-11-08&date_to=2026-11-09"Exemple payload (JSON):
{
"per_page": 10,
"page": 1,
"status": "in_use",
"date_from": "2026-11-08",
"date_to": "2026-11-09"
}Exemple réponse (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": "Informations complémentaires sur l'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": "Informations complémentaires sur l'eSIM"
}
],
"page": 1,
"per_page": 10,
"total": 42,
"total_pages": 5
},
"errorCode": null,
"errorMsg": null
}Détail de l'eSIM
| Paramètre query | Type | Requis | Défaut | Description |
|---|---|---|---|---|
id |
integer | Oui | ID eSIM (numérique). Utilisez id=0 pour tester | |
lang |
string | Non | Code de langue facultatif pour les liens PDF eSIM traduits. L’URL du PDF généré inclura ?lang={lang}. Exemple : en, fr, es, de. |
Curl:
curl -s -u "ck_key:cs_key" "https://simplesim.fr/wp-json/simplesim/v1/esims/0"Exemple réponse (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": "Informations complémentaires sur l'eSIM",
"activation_time": "2026-11-09T09:35:30+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
}Prérequis techniques & Compatibilité
Accès au serveur MCP :
Le serveur MCP simpleSIM est public et gratuit. Aucune clé API n’est requise pour les outils publics (catalogue, compatibilité des appareils, recherche dans la base de connaissances). Il suffit de renseigner l’URL du point de terminaison (https://simplesim.fr/en/wp-json/mcp/simplesim/) dans votre client MCP favori tel qu’Antigravity, Claude Desktop, Cursor, VS Code ou Windsurf.
Accès à l’API REST :
L’API REST est réservée aux partenaires B2B et aux développeurs enregistrés.
Pour obtenir vos accès :
- Créez un compte sur notre page simplesim.fr.
- Demandez l’activation de l’accès API auprès de votre responsable de compte ou du support client.
- Générez votre Consumer Key et votre Consumer Secret dans la rubrique Mon Compte -> API.
Limites de débit, format & conditions :
- API REST : Limitée à 10 requêtes par seconde et 10 000 requêtes par jour et par compte.
- Format des réponses : Toutes les réponses sont transmises au format JSON (Content-Type: application/json; charset=UTF-8).
- Devises & Tarifs : Les prix indiqués incluent les taxes (TTC) et sont exprimés en EUR ou USD selon la configuration.
- Conditions d’utilisation : L’usage des API est soumis à nos Conditions Générales de Vente.
Foire aux questions (FAQ)
Les clés API sont accessibles aux clients B2B. Créez un compte sur notre page d’inscription B2B, demandez l’activation de l’accès API auprès de votre responsable de compte ou via notre formulaire de contact, puis générez votre Consumer Key et Consumer Secret depuis la section Mon compte -> API. L’authentification s’effectue en HTTP Basic Auth sur l’ensemble des endpoints REST.
Oui, le serveur MCP simpleSIM est entièrement gratuit et ne nécessite aucune clé API pour l’utilisation des outils publics. Il est accessible à l’adresse https://simplesim.fr/en/wp-json/mcp/simplesim/ et peut être utilisé avec n’importe quel client compatible MCP (Antigravity, Claude Desktop, Cursor, VS Code, Windsurf, etc.). Les 5 outils publics (catalogue, compatibilité des appareils, recherche/lecture dans la base de connaissances, création de commande) sont utilisables sans authentification.
Le serveur MCP simpleSIM est compatible avec tout client prenant en charge le protocole MCP. Cela inclut Antigravity, Claude Desktop (Anthropic), Cursor, VS Code avec GitHub Copilot, Windsurf (Codeium), ainsi que tout agent IA personnalisé développé avec les bibliothèques MCP standards. La configuration prend quelques secondes : il suffit d’ajouter l’URL du serveur dans le fichier de configuration de votre client.
L’API REST est conçue pour les développeurs souhaitant intégrer l’achat d’eSIMs simpleSIM directement dans leurs propres applications (sites web, applications mobiles, logiciels de réservation). Elle nécessite des clés API et un compte B2B.
Le serveur MCP est conçu pour les assistants IA. Il permet à un agent IA (comme Antigravity, Claude ou Cursor) d’interagir directement avec simpleSIM pour consulter les offres, vérifier la compatibilité d’un smartphone ou générer des commandes – le tout en langage naturel. Il est gratuit et sans authentification pour les outils publics.
En résumé : l’API REST est faite pour vos applications, le serveur MCP est fait pour vos assistants IA.