Shop owners can specify which country or countries they will ship to and these countries are made available through the API using the province resource. 

States and provinces are represented by the province resource. We use the term "province" to cover both.

Province properties

code

"code": "VN"

The standard abbreviation for the state or province.

country_id

"country_id":  241

The unique numeric identifier for the country.

id

"id": 1

The unique numeric identifier for the state or province.

name

"name": "Hà Nội"

The full name of the state or province.

tax

"tax": 0.08

The national sales tax rate to be applied to orders made by customers from that province or state.

tax_name

"tax_name": null

The name of the tax for that province or state.

tax_type

"tax_type":null

Compounded sales tax.

tax_percentage

"tax_percentage ": null

The province or state's tax in percent format.

Endpoints

country_id

The id of the country the province belongs to.

since_id

Restrict results to after the specified ID

fields

comma-separated list of fields to include in the response.

Retrieve all provinces for a country.

GET https://apis.haravan.com/com/countries/241/provinces.json

View response

				

HTTP/1.1 200 OK

{ "provinces": [ { "code": "HI", "country_id": 241, "id": 1, "name": "Hà Nội", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HG", "country_id": 241, "id": 2, "name": "Hà Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "CB", "country_id": 241, "id": 3, "name": "Cao Bằng", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BK", "country_id": 241, "id": 4, "name": "Bắc Kạn", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TQ", "country_id": 241, "id": 5, "name": "Tuyên Quang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "LO", "country_id": 241, "id": 6, "name": "Lào Cai", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DB", "country_id": 241, "id": 7, "name": "Điện Biên", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "LI", "country_id": 241, "id": 8, "name": "Lai Châu", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "SL", "country_id": 241, "id": 9, "name": "Sơn La", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "YB", "country_id": 241, "id": 10, "name": "Yên Bái", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HO", "country_id": 241, "id": 11, "name": "Hòa Bình", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TY", "country_id": 241, "id": 12, "name": "Thái Nguyên", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "LS", "country_id": 241, "id": 13, "name": "Lạng Sơn", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "QN", "country_id": 241, "id": 14, "name": "Quảng Ninh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BG", "country_id": 241, "id": 15, "name": "Bắc Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "PT", "country_id": 241, "id": 16, "name": "Phú Thọ", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "VT", "country_id": 241, "id": 17, "name": "Vĩnh Phúc", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BN", "country_id": 241, "id": 18, "name": "Bắc Ninh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HD", "country_id": 241, "id": 19, "name": "Hải Dương", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HP", "country_id": 241, "id": 20, "name": "Hải Phòng", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HY", "country_id": 241, "id": 21, "name": "Hưng Yên", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TB", "country_id": 241, "id": 22, "name": "Thái Bình", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HM", "country_id": 241, "id": 23, "name": "Hà Nam", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "ND", "country_id": 241, "id": 24, "name": "Nam Định", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "NB", "country_id": 241, "id": 25, "name": "Ninh Bình", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TH", "country_id": 241, "id": 26, "name": "Thanh Hóa", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "NA", "country_id": 241, "id": 27, "name": "Nghệ An", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HT", "country_id": 241, "id": 28, "name": "Hà Tĩnh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "QB", "country_id": 241, "id": 29, "name": "Quảng Bình", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "QT", "country_id": 241, "id": 30, "name": "Quảng Trị", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TT", "country_id": 241, "id": 31, "name": "Thừa Thiên Huế", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DA", "country_id": 241, "id": 32, "name": "Đà Nẵng", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "QM", "country_id": 241, "id": 33, "name": "Quảng Nam", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "QG", "country_id": 241, "id": 34, "name": "Quảng Ngãi", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BD", "country_id": 241, "id": 35, "name": "Bình Định", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "PY", "country_id": 241, "id": 36, "name": "Phú Yên", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "KH", "country_id": 241, "id": 37, "name": "Khánh Hòa", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "NT", "country_id": 241, "id": 38, "name": "Ninh Thuận", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BU", "country_id": 241, "id": 39, "name": "Bình Thuận", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "KT", "country_id": 241, "id": 40, "name": "Kon Tum", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "GL", "country_id": 241, "id": 41, "name": "Gia Lai", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DC", "country_id": 241, "id": 42, "name": "Đắk Lắk", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DO", "country_id": 241, "id": 43, "name": "Đắk Nông", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "LD", "country_id": 241, "id": 44, "name": "Lâm Đồng", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BP", "country_id": 241, "id": 45, "name": "Bình Phước", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TN", "country_id": 241, "id": 46, "name": "Tây Ninh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BI", "country_id": 241, "id": 47, "name": "Bình Dương", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DN", "country_id": 241, "id": 48, "name": "Đồng Nai", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BV", "country_id": 241, "id": 49, "name": "Bà Rịa - Vũng Tàu", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HC", "country_id": 241, "id": 50, "name": "Hồ Chí Minh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "LA", "country_id": 241, "id": 51, "name": "Long An", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TG", "country_id": 241, "id": 52, "name": "Tiền Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BT", "country_id": 241, "id": 53, "name": "Bến Tre", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "TV", "country_id": 241, "id": 54, "name": "Trà Vinh", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "VL", "country_id": 241, "id": 55, "name": "Vĩnh Long", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "DT", "country_id": 241, "id": 56, "name": "Đồng Tháp", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "AG", "country_id": 241, "id": 57, "name": "An Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "KG", "country_id": 241, "id": 58, "name": "Kiên Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "CN", "country_id": 241, "id": 59, "name": "Cần Thơ", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "HU", "country_id": 241, "id": 60, "name": "Hậu Giang", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "ST", "country_id": 241, "id": 61, "name": "Sóc Trăng", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "BL", "country_id": 241, "id": 62, "name": "Bạc Liêu", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null }, { "code": "CM", "country_id": 241, "id": 63, "name": "Cà Mau", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null } ] }
GET https://apis.haravan.com/com/countries/{country_id}/provinces/count.json 

Retrieve a count all provinces for a country.

Retrieve a count all provinces for a country.

GET https://apis.haravan.com/com/countries/241/provinces/count.json

View response

HTTP/1.1 200 OK

{ "count": 63 }

Retrieves a single province for a country.

GET https://apis.haravan.com/com/countries/241/provinces/1.json

View response

				

HTTP/1.1 200 OK

{ "province": { "code": "HI", "country_id": 241, "id": 1, "name": "Hà Nội", "tax": null, "tax_name": null, "tax_type": null, "tax_percentage": null } }