API Documentation
eSIM API - Version 1.0
Security Notes
Price Calculation: All pricing is calculated server-side only. Client applications must never send amount or price data.
API Key Required: All requests require a valid API key. Never expose your API key in client-side code.
Base URL & Authentication
Base URL:
https://kripicard.com/api/esimAuthentication:
All endpoints require an api_key parameter in the request body.
1. Get eSIM Packages
POSTEndpoint:
POST /api/esim/packagesRequest Body
api_key (string) *required
Your API authentication key
page (integer) optional
Page number for pagination
per_page (integer) optional
Results per page
country (string) optional
Filter by country code (e.g., "US", "UK", "FR")
data (integer) optional
Filter by data amount in GB
duration (integer) optional
Filter by validity period in days
price (string) optional
Filter by price range (format: "min-max", e.g., "10-50")
Example Request
{
"api_key": "your_api_key_here",
"country": "US",
"data": 5,
"page": 1,
"per_page": 20
}Example Response
{
"success": true,
"data": {
"packages": [
{
"packageCode": "ESIM_US_5GB_30D",
"country": "United States",
"countryCode": "US",
"data": "5GB",
"duration": "30 days",
"price": 25.00,
"currency": "USD",
"coverage": "United States",
"network": "T-Mobile, AT&T"
}
],
"pagination": {
"page": 1,
"per_page": 20,
"total": 156
}
}
}2. Purchase eSIM
POSTEndpoint:
POST /api/esim/purchaseRequest Body
api_key (string) *required
Your API authentication key
recipient_email (email) *required
Email address to receive eSIM QR code and activation instructions
product_id (string) *required
Package code from the Get eSIM Packages endpoint (packageCode)
Important Security Note
Price is calculated server-side based on the product_id. Do NOT send any amount or price parameters. The server will determine the correct price and deduct from your account balance.
Example Request
{
"api_key": "your_api_key_here",
"recipient_email": "user@example.com",
"product_id": "ESIM_US_5GB_30D"
}Example Response
{
"success": true,
"data": {
"transaction_id": "TXN_1234567890",
"esim_code": "LPA:1$esim.example.com$ABC123XYZ",
"qr_code_url": "https://api.kripicard.com/esim/qr/ABC123XYZ",
"activation_instructions": "Scan QR code or enter code manually",
"package_details": {
"country": "United States",
"data": "5GB",
"duration": "30 days",
"price_paid": 25.00,
"currency": "USD"
},
"status": "active",
"created_at": "2026-01-06T12:00:00Z"
},
"message": "eSIM purchased successfully. Activation email sent to user@example.com"
}