Skip to content
API listProducts
API list

Product API

Get product list API

Returns all products distributed by SimplifyTrip.

Query Parameters
typeeSIM | SIM

Product type to filter by. Leave empty to get all.

querystring

Search keyword by name, id, country, or region…

countryIdstring

Country ID

regionIdstring

Region ID

takenumber

Number of results returned per page

skipnumber

Starting offset for returned results.

Responses
200 OK
application/json
Success
total - requirednumber
take - requirednumber
skip - requirednumber
items - required
4xx/5xx Error
application/json
Error
timestamptimestamp
statusCodenumber
errorCodestring
messagestring
GET
/api/v1/products
Sample Request
Try it on Swagger
Nodejs
PHP
C#
Java
Go
Curl

_35
// Using axios
_35
import axios from 'axios';
_35
_35
const options = {
_35
method: 'GET',
_35
url: 'https://merchant.simplifytrip.com/api/v1/products?take=10&skip=1',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
axios
_35
.request(options)
_35
.then(res => console.log(res.data))
_35
.catch(err => console.error(err));
_35
_35
// Using fetch api
_35
const url = 'https://merchant.simplifytrip.com/api/v1/products?take=10&skip=1';
_35
const options = {
_35
method: 'GET',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
fetch(url, options)
_35
.then(res => res.json())
_35
.then(json => console.log(json))
_35
.catch(err => console.error(err));

Sample Response

_145
{
_145
"total": 100,
_145
"skip": 0,
_145
"take": 10,
_145
"items": [
_145
{
_145
"spu": "EHKXY",
_145
"createdAt": "2024-10-21T03:07:09.818Z",
_145
"updatedAt": "2024-10-21T03:07:09.818Z",
_145
"name": {
_145
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only",
_145
"en": "eSIM HongKong, Macao 4G high speed, data only"
_145
},
_145
"slug": {
_145
"vi": "esim-hongkong-macao-toc-do-cao-4g-data",
_145
"en": "esim-hongkong-macao-4g-high-speed-data-only"
_145
},
_145
"type": "eSIM",
_145
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/esim/esim-hongkong-macao.jpg",
_145
"regions": [],
_145
"countries": [
_145
{
_145
"id": "HK",
_145
"name": {
_145
"vi": "Hong Kong",
_145
"en": "Hong Kong"
_145
},
_145
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/flag/hongkong-flag.jpg",
_145
"mcc": "HK",
_145
"mcc3": "HKG",
_145
"continent": "Asia"
_145
},
_145
{
_145
"id": "MO",
_145
"name": {
_145
"vi": "Macau (China)",
_145
"en": "Macau (China)"
_145
},
_145
"thumbnail": "https://op-flow-public.oss-cn-hangzhou.aliyuncs.com/module/country/aomen.png",
_145
"mcc": "MO",
_145
"mcc3": "MAC",
_145
"continent": "Asia"
_145
}
_145
],
_145
"variations": [
_145
{
_145
"sku": "EHKXY02GB05DPY",
_145
"name": {
_145
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 5 days)",
_145
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 5 days)"
_145
},
_145
"price": 270000,
_145
"priceFloor": 270000,
_145
"discount": 0,
_145
"highFlowSize": 2097152,
_145
"days": 5,
_145
"package": "DAILY",
_145
"data": "2GB",
_145
"throttleSpeed": "128kpbs",
_145
"smsCall": "TikTok is not supported",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB07DPY",
_145
"name": {
_145
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 7 days)",
_145
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 7 days)"
_145
},
_145
"price": 356000,
_145
"priceFloor": 356000,
_145
"discount": 0,
_145
"highFlowSize": 2097152,
_145
"days": 7,
_145
"package": "DAILY",
_145
"data": "2GB",
_145
"throttleSpeed": "128kpbs",
_145
"smsCall": "TikTok is not supported",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB06DPY",
_145
"name": {
_145
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 6 days)",
_145
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 6 days)"
_145
},
_145
"price": 313000,
_145
"priceFloor": 313000,
_145
"discount": 0,
_145
"highFlowSize": 2097152,
_145
"days": 6,
_145
"package": "DAILY",
_145
"data": "2GB",
_145
"throttleSpeed": "128kpbs",
_145
"smsCall": "TikTok is not supported",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY01GB01DPY",
_145
"name": {
_145
"vi": "eSIM Hong Kong high-speed 4G, data-only (1GB/day - 1 day)",
_145
"en": "4G high-speed Hongkong travel eSIM, data only (1GB/day - 1 day)"
_145
},
_145
"price": 93000,
_145
"priceFloor": 93000,
_145
"discount": 0,
_145
"highFlowSize": 1048576,
_145
"days": 1,
_145
"package": "DAILY",
_145
"data": "1GB",
_145
"throttleSpeed": "128kpbs",
_145
"smsCall": "TikTok is not supported",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB04DPY",
_145
"name": {
_145
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 4 days)",
_145
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 4 days)"
_145
},
_145
"price": 230000,
_145
"priceFloor": 230000,
_145
"discount": 0,
_145
"highFlowSize": 2097152,
_145
"days": 4,
_145
"package": "DAILY",
_145
"data": "2GB",
_145
"throttleSpeed": "128kpbs",
_145
"smsCall": "TikTok is not supported",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
}
_145
]
_145
},
_145
...
_145
]
_145
}

Get product details API

Get product detail by slug or SPU

Path Parameters
spu - required

string Slug or SPU from list API

Responses
200 OK
application/json
Success
4xx/5xx Error
application/json
Error
timestamptimestamp
statusCodenumber
errorCodestring
messagestring
GET
/api/v1/products/:spu
Sample Request
Try it on Swagger
Nodejs
PHP
C#
Java
Go
Curl

_35
// Using axios
_35
import axios from 'axios';
_35
_35
const options = {
_35
method: 'GET',
_35
url: 'https://merchant.simplifytrip.com/api/v1/products/EHKXY',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
axios
_35
.request(options)
_35
.then(res => console.log(res.data))
_35
.catch(err => console.error(err));
_35
_35
// Using fetch api
_35
const url = 'https://merchant.simplifytrip.com/api/v1/products/EHKXY';
_35
const options = {
_35
method: 'GET',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
fetch(url, options)
_35
.then(res => res.json())
_35
.then(json => console.log(json))
_35
.catch(err => console.error(err));

Sample Response

_137
{
_137
"spu": "EHKXY",
_137
"createdAt": "2024-10-21T03:07:09.818Z",
_137
"updatedAt": "2024-10-21T03:07:09.818Z",
_137
"name": {
_137
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only",
_137
"en": "eSIM HongKong, Macao 4G high speed, data only"
_137
},
_137
"slug": {
_137
"vi": "esim-hongkong-macao-toc-do-cao-4g-data",
_137
"en": "esim-hongkong-macao-4g-high-speed-data-only"
_137
},
_137
"type": "eSIM",
_137
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/esim/esim-hongkong-macao.jpg",
_137
"regions": [],
_137
"countries": [
_137
{
_137
"id": "HK",
_137
"name": {
_137
"vi": "Hong Kong",
_137
"en": "Hong Kong"
_137
},
_137
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/flag/hongkong-flag.jpg",
_137
"mcc": "HK",
_137
"mcc3": "HKG",
_137
"continent": "Asia"
_137
},
_137
{
_137
"id": "MO",
_137
"name": {
_137
"vi": "Macau (China)",
_137
"en": "Macau (China)"
_137
},
_137
"thumbnail": "https://op-flow-public.oss-cn-hangzhou.aliyuncs.com/module/country/aomen.png",
_137
"mcc": "MO",
_137
"mcc3": "MAC",
_137
"continent": "Asia"
_137
}
_137
],
_137
"variations": [
_137
{
_137
"sku": "EHKXY02GB05DPY",
_137
"name": {
_137
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 5 days)",
_137
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 5 days)"
_137
},
_137
"price": 270000,
_137
"priceFloor": 270000,
_137
"discount": 0,
_137
"highFlowSize": 2097152,
_137
"days": 5,
_137
"package": "DAILY",
_137
"data": "2GB",
_137
"throttleSpeed": "128kpbs",
_137
"smsCall": "TikTok is not supported",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB07DPY",
_137
"name": {
_137
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 7 days)",
_137
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 7 days)"
_137
},
_137
"price": 356000,
_137
"priceFloor": 356000,
_137
"discount": 0,
_137
"highFlowSize": 2097152,
_137
"days": 7,
_137
"package": "DAILY",
_137
"data": "2GB",
_137
"throttleSpeed": "128kpbs",
_137
"smsCall": "TikTok is not supported",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB06DPY",
_137
"name": {
_137
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 6 days)",
_137
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 6 days)"
_137
},
_137
"price": 313000,
_137
"priceFloor": 313000,
_137
"discount": 0,
_137
"highFlowSize": 2097152,
_137
"days": 6,
_137
"package": "DAILY",
_137
"data": "2GB",
_137
"throttleSpeed": "128kpbs",
_137
"smsCall": "TikTok is not supported",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY01GB01DPY",
_137
"name": {
_137
"vi": "eSIM Hong Kong high-speed 4G, data-only (1GB/day - 1 day)",
_137
"en": "4G high-speed Hongkong travel eSIM, data only (1GB/day - 1 day)"
_137
},
_137
"price": 93000,
_137
"priceFloor": 93000,
_137
"discount": 0,
_137
"highFlowSize": 1048576,
_137
"days": 1,
_137
"package": "DAILY",
_137
"data": "1GB",
_137
"throttleSpeed": "128kpbs",
_137
"smsCall": "TikTok is not supported",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB04DPY",
_137
"name": {
_137
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 4 days)",
_137
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 4 days)"
_137
},
_137
"price": 230000,
_137
"priceFloor": 230000,
_137
"discount": 0,
_137
"highFlowSize": 2097152,
_137
"days": 4,
_137
"package": "DAILY",
_137
"data": "2GB",
_137
"throttleSpeed": "128kpbs",
_137
"smsCall": "TikTok is not supported",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
}
_137
]
_137
}

Get variation details API

Get variation detail by SKU

Path Parameters
sku - requiredstring
Responses
200 OK
application/json
Success
4xx/5xx Error
application/json
Error
timestamptimestamp
statusCodenumber
errorCodestring
messagestring
GET
/api/v1/products/variation/:sku
Sample Request
Try it on Swagger
Nodejs
PHP
C#
Java
Go
Curl

_35
// Using axios
_35
import axios from 'axios';
_35
_35
const options = {
_35
method: 'GET',
_35
url: 'https://merchant.simplifytrip.com/api/v1/products/variation/EHKXY01GB01DPY',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
axios
_35
.request(options)
_35
.then(res => console.log(res.data))
_35
.catch(err => console.error(err));
_35
_35
// Using fetch api
_35
const url = 'https://merchant.simplifytrip.com/api/v1/products/variation/EHKXY01GB01DPY';
_35
const options = {
_35
method: 'GET',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
fetch(url, options)
_35
.then(res => res.json())
_35
.then(json => console.log(json))
_35
.catch(err => console.error(err));

Sample Response

_20
{
_20
"sku": "EHKXY02GB06DPY",
_20
"name": {
_20
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 6 days)",
_20
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 6 days)"
_20
},
_20
"price": 313000,
_20
"priceFloor": 313000,
_20
"discount": 0,
_20
"highFlowSize": 2097152,
_20
"days": 6,
_20
"package": "DAILY",
_20
"data": "2GB",
_20
"throttleSpeed": "128kpbs",
_20
"smsCall": "TikTok is not supported",
_20
"apn": "Auto",
_20
"pointContactType": null,
_20
"hotsPot": true,
_20
"spu": "EHKXY"
_20
}

Get purchased eSIM status by ICCID API

Get eSIM information, including status, activity history, and data usage…

Path Parameters
iccid - requiredstring
Responses
200 OK
application/json
Success
iccidstring
activityLogs
usageInfoList
eSimStatus
productInfo
orderInfo
4xx/5xx Error
application/json
Error
timestamptimestamp
statusCodenumber
errorCodestring
messagestring
GET
/api/v1/products/esim/:iccid
Sample Request
Try it on Swagger
Nodejs
PHP
C#
Java
Go
Curl

_35
// Using axios
_35
import axios from 'axios';
_35
_35
const options = {
_35
method: 'GET',
_35
url: 'https://merchant.simplifytrip.com/api/v1/products/iccid/89812003916820412483',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
axios
_35
.request(options)
_35
.then(res => console.log(res.data))
_35
.catch(err => console.error(err));
_35
_35
// Using fetch api
_35
const url = 'https://merchant.simplifytrip.com/api/v1/products/iccid/89812003916820412483';
_35
const options = {
_35
method: 'GET',
_35
headers: {
_35
accept: 'application/json',
_35
'content-type': 'application/json',
_35
authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxx',
_35
'x-api-key': 'pk_live_xxxxxxxxxxxxxxxxxx',
_35
}
_35
};
_35
_35
fetch(url, options)
_35
.then(res => res.json())
_35
.then(json => console.log(json))
_35
.catch(err => console.error(err));

Sample Response

_43
{
_43
"activityLogs": [
_43
{
_43
"eid": null,
_43
"recordTime": "2025-05-13 22:42:42",
_43
"status": 0
_43
}
_43
],
_43
"usageInfoList": [],
_43
"eSimStatus": {
_43
"planStartTime": null,
_43
"planEndTime": null,
_43
"remainingDays": 1,
_43
"useEndTime": "",
_43
"usedTraffic": 0,
_43
"planStatus": 0
_43
},
_43
"iccid": "89812003916820447472",
_43
"orderInfo": {
_43
"orderId": "481989189736539",
_43
"trackId": "2f01814f-d3da-40ae-afd1-79cbd8f789e3",
_43
"subOrderId": "68235a3f02fe66336899c820",
_43
"subTrackId": "18824662-0ba2-4fe5-a22f-b7475755335f",
_43
"purchaseDate": "2025-05-13T14:42:07.069Z"
_43
},
_43
"productInfo": {
_43
"sku": "E23XY06GB08DFX",
_43
"spu": "E23XY",
_43
"name": {
_43
"vi": "eSIM India 06GB high-speed 4G, data-only (6GB - 8 days)",
_43
"en": "4G high-speed India travel eSIM, data only (6GB - 8 days ) "
_43
},
_43
"type": "eSIM",
_43
"package": "FIXED",
_43
"days": 8,
_43
"data": "6GB",
_43
"apn": "internet",
_43
"hotsPot": true,
_43
"throttleSpeed": "Stop",
_43
"pointContactType": null,
_43
"smsCall": "Available countries: Australia, Brunei, Bahrain, Bhutan, Georgia, Cambodia, China (including Tibet), Hong Kong, India, Indonesia, Japan, Laos, Macau, Malaysia, Myanmar, Nepal, Philippines, Qatar, Singapore, South Korea, Sri Lanka, Taiwan, Thailand, Vietnam, Bangladesh, Israel, Kazakhstan, Pakistan, Guam, Kuwait, Uzbekistan, Oman, Mongolia, Jordan."
_43
}
_43
}

API listCountry