We just GoLive API Rate Limits. Please follow up

Get Province List By Country

GET

/api/v2/addresses/country/{country_code}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.omisell.com/api/v2/addresses/country/?is_new_address=undefined' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Response Example

Real response captured from the live API. Personal data replaced with placeholders. Trimmed to the first 3 rows.

{
    "data": [
        {
            "id": 1,
            "country_code": "VN",
            "code": "HNI",
            "province_name": "Hà Nội",
            "province_name_local": "Hà Nội",
            "province_name_convert": "hanoi",
            "state_id": 1,
            "priority": 1,
            "is_new_address": false
        },
        {
            "id": 466589,
            "country_code": "VN",
            "code": "HNI",
            "province_name": "Hà Nội",
            "province_name_local": "Hà Nội (Mới)",
            "province_name_convert": "hanoi",
            "state_id": 1,
            "priority": 1,
            "is_new_address": true
        },
        {
            "id": 79,
            "country_code": "VN",
            "code": "HCM",
            "province_name": "TP. Hồ Chí Minh",
            "province_name_local": "TP. Hồ Chí Minh",
            "province_name_convert": "tphochiminh",
            "state_id": 3,
            "priority": 2,
            "is_new_address": false
        }
    ],
    "error": false,
    "error_code": 200,
    "attr_error": null,
    "messages": ""
}

Modified at 2026-09-02 05:41:20

Get Country List

Get District List By Province