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 7 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"
}
}
}Modèle d’accès
Le point d’accès est identique pour les clients MCP publics et authentifiés. Les outils de catalogue, de compatibilité, de base de connaissances et de création de commande sont accessibles publiquement. Les outils de consultation des eSIM et des commandes nécessitent un agent MCP authentifié.
Clients authentifiés
L’accès en tant qu’agent MCP authentifié nécessite une autorisation préalable. Contactez l’équipe simpleSIM pour demander un compte autorisé.
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.
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
Les clients MCP publics peuvent créer une commande sans compte client. La commande créée est une commande invitée et le payment_url retourné peut être ouvert par le client 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.
Agents MCP authentifiés
Lorsqu’un agent MCP authentifié crée une commande, celle-ci est associée au compte de cet agent au lieu d’être créée comme commande invitée. Les limites anti-abus publiques ne s’appliquent pas aux agents MCP autorisés.
Nouvelles tentatives sécurisées
Le paramètre facultatif idempotency_key peut être fourni lors de la création d’une commande. Réutiliser la même clé avec les mêmes paramètres retourne de façon sûre la commande existante. Sa réutilisation avec des paramètres différents est refusée afin d’éviter les doublons ou les commandes contradictoires.
Paiement et accès à la commande
La création d’une commande publique retourne uniquement le lien de paiement ; elle ne donne pas accès aux outils de consultation des commandes ou des eSIM. order-get-summary et esim-get-public restent réservés aux agents MCP authentifiés et n’exposent que les ressources associées à ce client autorisé.
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 available details of an eSIM, together with basic information about its order. Authorized MCP Agent access is required.
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. Authorized MCP Agent access is required.
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_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
}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": "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
}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 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
}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-10-19T20:36:52+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-10-18&date_to=2026-10-19"Exemple payload (JSON):
{
"per_page": 10,
"page": 1,
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}Exemple réponse (JSON):
{
"success": true,
"obj": {
"orders": [
{
"id": 8002,
"status": "completed",
"created_at": "2026-10-19T18:36:52+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-10-19T18:36:52+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-10-18&date_to=2026-10-19"Exemple payload (JSON):
{
"per_page": 10,
"page": 1,
"status": "in_use",
"date_from": "2026-10-18",
"date_to": "2026-10-19"
}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-10-19T20:36:52+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.