API ReferenceLocations
Locations API
APIs for provinces/cities, districts, and wards using legacy and new administrative location systems.
GET
/v3/loc/provincesGet the list of provinces and cities.
Auth: Bearer access token
GET
/v3/loc/districtsGet the list of districts by province or city.
Auth: Bearer access token
GET
/v3/loc/wardsGet the list of wards by legacy district or new province/city.
Auth: Bearer access token
New administrative locations
Nhất Tín has added support for the new government location codes. Shipment creation and fee calculation integrations should prefer the new province/city and ward codes to be production-ready.
| Resource | Endpoint | Main parameters |
|---|---|---|
| Province/City | /v3/loc/provinces | is_new |
| District | /v3/loc/districts | province_id |
| Ward | /v3/loc/wards | district_id, is_new, province_id |