Data Packages API

Request a list of all available data packages. Optionally filter by country, region, or get top-up plans for existing eSIMs.

Get All Data Packages

Endpoint: POST /api/v1/open/package/list

Request Parameters

Name	Type	Required	Description	Example
`locationCode`	String	Optional	Filter by Alpha-2 ISO Country Code. Use `!RG` for Regional, `!GL` for Global	`JP`, `!GL`, `!RG`
`type`	String	Optional	`BASE` - Default products, `TOPUP` - Top up products	`BASE`, `TOPUP`
`packageCode`	String	Optional	Used with `TOPUP` to view top-up packages	`JC016`
`slug`	String	Optional	Alias of `packageCode`	`AU_1_7`
`iccid`	String	Optional	Include with `TOPUP` to see available top-up plans	`48584984747372838`
`dataType`	String	Optional	`1` = Fixed Plans, `2` = Day Pass Plans	`2`

Example Request

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "locationCode": "TH",
    "type": "BASE"
}'

Response Parameters

Name	Type	Description
`success`	Boolean	`true` = succeeded, `false` = failed
`errorCode`	String	`null` or error code when failed
`errorMsg`	String	Error message explanation
`obj.packageList`	Array	List of available packages

Package Object

Field	Type	Description	Example
`packageCode`	String	Unique package identifier	`JC016`
`slug`	String	Package alias	`AU_1_7`
`name`	String	Package display name	`Thailand 1GB 7 Days`
`price`	Integer	Price * 10,000 ($1.00 = 10000)	`45000`
`currencyCode`	String	Currency code	`USD`
`volume`	Long	Data volume in bytes	`1073741824`
`smsStatus`	Integer	`0` = SMS not supported, `1` = API + mobile SMS, `2` = API SMS only	`0`
`dataType`	Integer	`1` = Data in Total, `2` = Daily Limit (Speed Reduced), `3` = Daily Limit (Cut-off), `4` = Daily Unlimited	`1`
`unusedValidTime`	Integer	Days until package expires if unused	`30`
`duration`	Integer	Plan validity period	`7`
`durationUnit`	String	Time unit (`DAY`)	`DAY`
`location`	String	Comma-separated Alpha-2 ISO codes	`TH`
`description`	String	Package description	`Thailand 1GB 7 Days`
`activeType`	Integer	`1` = First installation, `2` = First network connection	`1`
`favorite`	Boolean	Favorited plan	`false`
`retailPrice`	Integer	Suggested retail price	`71000`
`speed`	String	Network speed	`3G/4G/5G`
`locationNetworkList`	Array	Location and network info
`operatorList`	Array	Operator names and network types
`ipExport`	String	Data traffic exit country	`TH`
`supportTopUpType`	Integer	`1` = No top-up, `2` = Top-up supported	`2`
`fupPolicy`	String	Fair Use Policy speed after limit	`384 Kbps`

Example Response

{
    "errorCode": null,
    "errorMsg": null,
    "success": true,
    "obj": {
        "packageList": [
            {
                "packageCode": "TH_1_7",
                "slug": "TH_1_7",
                "name": "Thailand 1GB 7 Days",
                "price": 45000,
                "currencyCode": "USD",
                "volume": 1073741824,
                "smsStatus": 0,
                "dataType": 1,
                "unusedValidTime": 180,
                "duration": 7,
                "durationUnit": "DAY",
                "location": "TH",
                "description": "Thailand 1GB 7 Days",
                "activeType": 1,
                "favorite": false,
                "retailPrice": 71000,
                "speed": "3G/4G",
                "locationNetworkList": [
                    {
                        "locationName": "Thailand",
                        "locationLogo": "https://static.redteago.com/img/logos/ThailandFlag.png",
                        "operatorList": [
                            {
                                "operatorName": "AIS",
                                "networkType": "4G/5G"
                            }
                        ]
                    }
                ],
                "ipExport": "TH",
                "supportTopUpType": 2
            }
        ]
    }
}

Get Top-Up Plans for Package

Use type: "TOPUP" with packageCode or slug to get available top-up plans.

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "type": "TOPUP",
    "packageCode": "TH_1_7"
}'

Get Top-Up Plans for ICCID

Use type: "TOPUP" with iccid to get available top-up plans for an existing eSIM.

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "type": "TOPUP",
    "iccid": "8901234567890123456"
}'

Get Day Pass Plans

Use dataType: "2" to filter for day pass (unlimited daily) plans.

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "locationCode": "JP",
    "dataType": "2"
}'

Get Plans by Country

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "locationCode": "US"
}'

Get Regional Plans

Use !RG for regional multi-country packages.

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "locationCode": "!RG"
}'

Get Global Plans

Use !GL for global worldwide packages.

curl --location --request POST 'https://your-api-domain.com/api/v1/open/package/list' \
--header 'RT-AccessCode: YOUR_ACCESS_CODE' \
--header 'RT-SecretKey: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "locationCode": "!GL"
}'

Overview Order Profiles