Skip to content
API listProducts
API list

Product API

Get product list API

Returns all products distributed by SimplifyTrip.

Query Parameters
typeeSIM | SIM | SIM_RECHARGE

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

_149
{
_149
"total": 100,
_149
"skip": 0,
_149
"take": 10,
_149
"items": [
_149
{
_149
"spu": "EHKXY",
_149
"createdAt": "2024-10-21T03:07:09.818Z",
_149
"updatedAt": "2024-10-21T03:07:09.818Z",
_149
"name": {
_149
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only",
_149
"en": "eSIM HongKong, Macao 4G high speed, data only"
_149
},
_149
"slug": {
_149
"vi": "esim-trung-quoc-hongkong-macao-4g-chi-co-data",
_149
"en": "esim-china-hongkong-macao-4g-data-only"
_149
},
_149
"metadata": {
_149
"vi": "<ul>\n <li><strong>Nhà cung cấp:</strong> BC</li>\n <li>Thời gian làm mới dung lượng: 00:00 - 24:00 (UTC+8)</li>\n <li>Quét mã QR trước chuyến bay và bật Chuyển vùng dữ liệu khi đến nơi.</li>\n <li>Hotspot: Hỗ trợ</li>\n <li><strong>Android:</strong> ❌ Không hỗ trợ TikTok</li>\n <li><strong>iOS:</strong> ❌ Không hỗ trợ TikTok</li>\n <li><strong>Phạm vi phủ sóng:</strong> Trung Quốc, Hongkong, Macao</li>\n <li><strong>Nhà mạng:</strong> CSL,\tChina Telecom HK(CSL),ChinaTelecom (4G/5G)</li>\n <li><strong>APN:</strong> CTExcel</li>\n <li>Tốc độ giảm còn 384kbps sau khi sử dụng hết dung lượng tốc độ cao trong ngày.</li>\n <li><strong>TikTok:</strong> Tắt Truy cập vị trí, Hoạt động trực tiếp và Cho phép theo dõi trước khi khởi hành. Nhà cung cấp không chịu trách nhiệm nếu chưa thực hiện các bước trên.</li>\n</ul>",
_149
"en": "<ul>\n <li><strong>Provider:</strong> BC</li>\n <li>Data refresh time: 00:00 - 24:00 (UTC+8)</li>\n <li>Scan the QR code before your flight and enable Data Roaming upon arrival.</li>\n <li>Hotspot: Supported</li>\n <li><strong>Android:</strong> ❌ TikTok not supported</li>\n <li><strong>iOS:</strong> ❌ TikTok not supported</li>\n <li><strong>Coverage:</strong> China, Hong Kong, Macau</li>\n <li><strong>Network operators:</strong> CSL, China Telecom HK (CSL), China Telecom (4G/5G)</li>\n <li><strong>APN:</strong> CTExcel</li>\n <li>Speed reduced to 384kbps after using the daily high-speed data limit.</li>\n <li><strong>TikTok:</strong> Turn off Location Access, Live Activities, and Allow Tracking before departure. The provider is not responsible if these steps are not followed.</li>\n</ul>"
_149
},
_149
"type": "eSIM",
_149
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/esim/esim-hongkong-macao.jpg",
_149
"regions": [],
_149
"countries": [
_149
{
_149
"id": "HK",
_149
"name": {
_149
"vi": "Hong Kong",
_149
"en": "Hong Kong"
_149
},
_149
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/flag/hongkong-flag.jpg",
_149
"mcc": "HK",
_149
"mcc3": "HKG",
_149
"continent": "Asia"
_149
},
_149
{
_149
"id": "MO",
_149
"name": {
_149
"vi": "Macau (China)",
_149
"en": "Macau (China)"
_149
},
_149
"thumbnail": "https://op-flow-public.oss-cn-hangzhou.aliyuncs.com/module/country/aomen.png",
_149
"mcc": "MO",
_149
"mcc3": "MAC",
_149
"continent": "Asia"
_149
}
_149
],
_149
"variations": [
_149
{
_149
"sku": "EHKXY02GB05DPY",
_149
"name": {
_149
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 5 days)",
_149
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 5 days)"
_149
},
_149
"price": 270000,
_149
"priceFloor": 270000,
_149
"discount": 0,
_149
"highFlowSize": 2097152,
_149
"days": 5,
_149
"package": "DAILY",
_149
"data": "2GB",
_149
"throttleSpeed": "128kpbs",
_149
"smsCall": "TikTok is not supported",
_149
"apn": "Auto",
_149
"pointContactType": null,
_149
"hotsPot": true
_149
},
_149
{
_149
"sku": "EHKXY02GB07DPY",
_149
"name": {
_149
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 7 days)",
_149
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 7 days)"
_149
},
_149
"price": 356000,
_149
"priceFloor": 356000,
_149
"discount": 0,
_149
"highFlowSize": 2097152,
_149
"days": 7,
_149
"package": "DAILY",
_149
"data": "2GB",
_149
"throttleSpeed": "128kpbs",
_149
"smsCall": "TikTok is not supported",
_149
"apn": "Auto",
_149
"pointContactType": null,
_149
"hotsPot": true
_149
},
_149
{
_149
"sku": "EHKXY02GB06DPY",
_149
"name": {
_149
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 6 days)",
_149
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 6 days)"
_149
},
_149
"price": 313000,
_149
"priceFloor": 313000,
_149
"discount": 0,
_149
"highFlowSize": 2097152,
_149
"days": 6,
_149
"package": "DAILY",
_149
"data": "2GB",
_149
"throttleSpeed": "128kpbs",
_149
"smsCall": "TikTok is not supported",
_149
"apn": "Auto",
_149
"pointContactType": null,
_149
"hotsPot": true
_149
},
_149
{
_149
"sku": "EHKXY01GB01DPY",
_149
"name": {
_149
"vi": "eSIM Hong Kong high-speed 4G, data-only (1GB/day - 1 day)",
_149
"en": "4G high-speed Hongkong travel eSIM, data only (1GB/day - 1 day)"
_149
},
_149
"price": 93000,
_149
"priceFloor": 93000,
_149
"discount": 0,
_149
"highFlowSize": 1048576,
_149
"days": 1,
_149
"package": "DAILY",
_149
"data": "1GB",
_149
"throttleSpeed": "128kpbs",
_149
"smsCall": "TikTok is not supported",
_149
"apn": "Auto",
_149
"pointContactType": null,
_149
"hotsPot": true
_149
},
_149
{
_149
"sku": "EHKXY02GB04DPY",
_149
"name": {
_149
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 4 days)",
_149
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 4 days)"
_149
},
_149
"price": 230000,
_149
"priceFloor": 230000,
_149
"discount": 0,
_149
"highFlowSize": 2097152,
_149
"days": 4,
_149
"package": "DAILY",
_149
"data": "2GB",
_149
"throttleSpeed": "128kpbs",
_149
"smsCall": "TikTok is not supported",
_149
"apn": "Auto",
_149
"pointContactType": null,
_149
"hotsPot": true
_149
}
_149
]
_149
},
_149
...
_149
]
_149
}

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

_141
{
_141
"spu": "EHKXY",
_141
"createdAt": "2024-10-21T03:07:09.818Z",
_141
"updatedAt": "2024-10-21T03:07:09.818Z",
_141
"name": {
_141
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only",
_141
"en": "eSIM HongKong, Macao 4G high speed, data only"
_141
},
_141
"slug": {
_141
"vi": "esim-hongkong-macao-toc-do-cao-4g-data",
_141
"en": "esim-hongkong-macao-4g-high-speed-data-only"
_141
},
_141
"metadata": {
_141
"vi": "<ul>\n <li><strong>Nhà cung cấp:</strong> BC</li>\n <li>Thời gian làm mới dung lượng: 00:00 - 24:00 (UTC+8)</li>\n <li>Quét mã QR trước chuyến bay và bật Chuyển vùng dữ liệu khi đến nơi.</li>\n <li>Hotspot: Hỗ trợ</li>\n <li><strong>Android:</strong> ❌ Không hỗ trợ TikTok</li>\n <li><strong>iOS:</strong> ❌ Không hỗ trợ TikTok</li>\n <li><strong>Phạm vi phủ sóng:</strong> Trung Quốc, Hongkong, Macao</li>\n <li><strong>Nhà mạng:</strong> CSL,\tChina Telecom HK(CSL),ChinaTelecom (4G/5G)</li>\n <li><strong>APN:</strong> CTExcel</li>\n <li>Tốc độ giảm còn 384kbps sau khi sử dụng hết dung lượng tốc độ cao trong ngày.</li>\n <li><strong>TikTok:</strong> Tắt Truy cập vị trí, Hoạt động trực tiếp và Cho phép theo dõi trước khi khởi hành. Nhà cung cấp không chịu trách nhiệm nếu chưa thực hiện các bước trên.</li>\n</ul>",
_141
"en": "<ul>\n <li><strong>Provider:</strong> BC</li>\n <li>Data refresh time: 00:00 - 24:00 (UTC+8)</li>\n <li>Scan the QR code before your flight and enable Data Roaming upon arrival.</li>\n <li>Hotspot: Supported</li>\n <li><strong>Android:</strong> ❌ TikTok not supported</li>\n <li><strong>iOS:</strong> ❌ TikTok not supported</li>\n <li><strong>Coverage:</strong> China, Hong Kong, Macau</li>\n <li><strong>Network operators:</strong> CSL, China Telecom HK (CSL), China Telecom (4G/5G)</li>\n <li><strong>APN:</strong> CTExcel</li>\n <li>Speed reduced to 384kbps after using the daily high-speed data limit.</li>\n <li><strong>TikTok:</strong> Turn off Location Access, Live Activities, and Allow Tracking before departure. The provider is not responsible if these steps are not followed.</li>\n</ul>"
_141
},
_141
"type": "eSIM",
_141
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/esim/esim-hongkong-macao.jpg",
_141
"regions": [],
_141
"countries": [
_141
{
_141
"id": "HK",
_141
"name": {
_141
"vi": "Hong Kong",
_141
"en": "Hong Kong"
_141
},
_141
"thumbnail": "https://awssimplifytrip.s3.ap-southeast-1.amazonaws.com/flag/hongkong-flag.jpg",
_141
"mcc": "HK",
_141
"mcc3": "HKG",
_141
"continent": "Asia"
_141
},
_141
{
_141
"id": "MO",
_141
"name": {
_141
"vi": "Macau (China)",
_141
"en": "Macau (China)"
_141
},
_141
"thumbnail": "https://op-flow-public.oss-cn-hangzhou.aliyuncs.com/module/country/aomen.png",
_141
"mcc": "MO",
_141
"mcc3": "MAC",
_141
"continent": "Asia"
_141
}
_141
],
_141
"variations": [
_141
{
_141
"sku": "EHKXY02GB05DPY",
_141
"name": {
_141
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 5 days)",
_141
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 5 days)"
_141
},
_141
"price": 270000,
_141
"priceFloor": 270000,
_141
"discount": 0,
_141
"highFlowSize": 2097152,
_141
"days": 5,
_141
"package": "DAILY",
_141
"data": "2GB",
_141
"throttleSpeed": "128kpbs",
_141
"smsCall": "TikTok is not supported",
_141
"apn": "Auto",
_141
"pointContactType": null,
_141
"hotsPot": true
_141
},
_141
{
_141
"sku": "EHKXY02GB07DPY",
_141
"name": {
_141
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 7 days)",
_141
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 7 days)"
_141
},
_141
"price": 356000,
_141
"priceFloor": 356000,
_141
"discount": 0,
_141
"highFlowSize": 2097152,
_141
"days": 7,
_141
"package": "DAILY",
_141
"data": "2GB",
_141
"throttleSpeed": "128kpbs",
_141
"smsCall": "TikTok is not supported",
_141
"apn": "Auto",
_141
"pointContactType": null,
_141
"hotsPot": true
_141
},
_141
{
_141
"sku": "EHKXY02GB06DPY",
_141
"name": {
_141
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 6 days)",
_141
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 6 days)"
_141
},
_141
"price": 313000,
_141
"priceFloor": 313000,
_141
"discount": 0,
_141
"highFlowSize": 2097152,
_141
"days": 6,
_141
"package": "DAILY",
_141
"data": "2GB",
_141
"throttleSpeed": "128kpbs",
_141
"smsCall": "TikTok is not supported",
_141
"apn": "Auto",
_141
"pointContactType": null,
_141
"hotsPot": true
_141
},
_141
{
_141
"sku": "EHKXY01GB01DPY",
_141
"name": {
_141
"vi": "eSIM Hong Kong high-speed 4G, data-only (1GB/day - 1 day)",
_141
"en": "4G high-speed Hongkong travel eSIM, data only (1GB/day - 1 day)"
_141
},
_141
"price": 93000,
_141
"priceFloor": 93000,
_141
"discount": 0,
_141
"highFlowSize": 1048576,
_141
"days": 1,
_141
"package": "DAILY",
_141
"data": "1GB",
_141
"throttleSpeed": "128kpbs",
_141
"smsCall": "TikTok is not supported",
_141
"apn": "Auto",
_141
"pointContactType": null,
_141
"hotsPot": true
_141
},
_141
{
_141
"sku": "EHKXY02GB04DPY",
_141
"name": {
_141
"vi": "eSIM Hong Kong, Macau high-speed 4G, data-only (2GB/day - 4 days)",
_141
"en": "eSIM for Hong Kong travel with unlimited 4G high-speed capacity, only data (2GB/day - 4 days)"
_141
},
_141
"price": 230000,
_141
"priceFloor": 230000,
_141
"discount": 0,
_141
"highFlowSize": 2097152,
_141
"days": 4,
_141
"package": "DAILY",
_141
"data": "2GB",
_141
"throttleSpeed": "128kpbs",
_141
"smsCall": "TikTok is not supported",
_141
"apn": "Auto",
_141
"pointContactType": null,
_141
"hotsPot": true
_141
}
_141
]
_141
}

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
}

API listCountry