Skip to content
Danh sách APIsMặt hàng
Danh sách APIs

Api mặt hàng

Api lấy danh sách các mặt hàng

Trả về danh sách tất cả các mặt hàng do SimplifyTrip phân phối

Query Parameters
typeeSIM | SIM

Loại sản phẩm mà bạn muốn lọc, bỏ trống để lấy tất cả

querystring

Từ khoá tìm kiếm theo tên, id, quốc gia hoặc khu vực…

takenumber

Số lượng kết quả trả về cho một trang

skipnumber

Chỉ mục ban đầu để trả về kết quả.

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 HongKong, Macao tốc độ cao 4G, chỉ có data ",
_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 HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 5 ngày)",
_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": "Không dùng được Tiktok",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB07DPY",
_145
"name": {
_145
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 7 ngày)",
_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": "Không dùng được Tiktok",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB06DPY",
_145
"name": {
_145
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 6 ngày)",
_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": "Không dùng được Tiktok",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY01GB01DPY",
_145
"name": {
_145
"vi": "eSIM HongKong tốc độ cao 4G, chỉ có data (1GB/ngày - 1 ngày)",
_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": "Không dùng được Tiktok",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
},
_145
{
_145
"sku": "EHKXY02GB04DPY",
_145
"name": {
_145
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 4 ngày)",
_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": "Không dùng được Tiktok",
_145
"apn": "Auto",
_145
"pointContactType": null,
_145
"hotsPot": true
_145
}
_145
]
_145
},
_145
...
_145
]
_145
}

Api lấy thông tin một mặt hàng

Api lấy thông tin chi tiết một mặt hàng của SimplifyTrip thông qua slug hoặc spu

Path Parameters
spu - required

string slug hoặc spu lấy từ API get danh sách

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 HongKong, Macao tốc độ cao 4G, chỉ có data ",
_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 HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 5 ngày)",
_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": "Không dùng được Tiktok",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB07DPY",
_137
"name": {
_137
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 7 ngày)",
_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": "Không dùng được Tiktok",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB06DPY",
_137
"name": {
_137
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 6 ngày)",
_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": "Không dùng được Tiktok",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY01GB01DPY",
_137
"name": {
_137
"vi": "eSIM HongKong tốc độ cao 4G, chỉ có data (1GB/ngày - 1 ngày)",
_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": "Không dùng được Tiktok",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
},
_137
{
_137
"sku": "EHKXY02GB04DPY",
_137
"name": {
_137
"vi": "eSIM HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 4 ngày)",
_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": "Không dùng được Tiktok",
_137
"apn": "Auto",
_137
"pointContactType": null,
_137
"hotsPot": true
_137
}
_137
]
_137
}

Api lấy thông tin một variation

Api lấy thông tin chi tiết một mẫu mã của mặt hàng thông qua 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 HongKong, Macao tốc độ cao 4G, chỉ có data (2GB/ngày - 6 ngày)",
_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": "Không dùng được Tiktok",
_20
"apn": "Auto",
_20
"pointContactType": null,
_20
"hotsPot": true,
_20
"spu": "EHKXY"
_20
}

Api tra cứu trạng thái eSim đã mua thông qua ICCID

Api lấy thông tin eSim, bao gồm Trạng thái, lịch sử hoạt động, lượng dữ liệu đã sử dụng…

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 Ấn Độ 06GB tốc độ cao 4G, chỉ có data (6GB - 8 ngày ) ",
_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": "Các nước có thể sử dụng: 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 , Qatar , Oman , Mongolia , Jordan ."
_43
}
_43
}

Danh sách APIsQuốc gia