10. Special Address Lookup API

This API fetches the list of level-4 addresses within a specific street/ward/commune. For some locations, this information is required when creating an order via the order creation API

Endpoint

GET /services/address/getAddressLevel4

Headers

• Token: {API_TOKEN}
• X-Client-Source: {PARTNER_CODE}
• Content-Type: application/json

Sample Request

HTTP

GET /services/address/getAddressLevel4?province=h%C3%A0%20n%E1%BB%99i&district=ba%20%C4%91%C3%ACnh&ward_street=%C4%91%E1%BB%99i%20c%E1%BA%A5n&address=20 HTTP/1.1
Token: {API_TOKEN}
X-Client-Source: {PARTNER_CODE}

CURL

curl -X GET -H "Token: {API_TOKEN}"\
-H "X-Client-Source: {PARTNER_CODE}"\
"{OPEN_API}/services/address/getAddressLevel4?province=h%C3%A0%20n%E1%BB%99i&district=ba%20%C4%91%C3%ACnh&ward_street=%C4%91%E1%BB%99i%20c%E1%BA%A5n&address=20"

PHP

<?php
$data = array(
    "province" => "Hà nội",
    "district" => "Quận Ba Đình",
    "ward_street" => "Đội Cấn",
    "address" => "",
);
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://services.giaohangtietkiem.vn/services/address/getAddressLevel4?" . http_build_query($data),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_HTTPHEADER => array(
        "Token: APITokenSample-ca441e70288cB0515F310742",
    ),
));

$response = curl_exec($curl);
curl_close($curl);

echo 'Response: ' . $response;
?>

Parameters

Parameter	Required	Description
address	no	String - Full information of level-4 addresses from (e.g., Đội Cấn street, Ba Đình, Hà Nội)
province	yes	String - Province/City name of level-4 addresses
district	yes	String - District name of level-4 addresses
ward_street	yes	String - Ward/Street name of level-4 addresses

warning

Note: If a valid address is provided, the province, district, and ward/street fields will automatically be inferred from that address, so fields like province, district, ward_street are not required.

Response

{
  "success": true,
  "data": [
    "IIG - 75 Giang Văn Minh",
    "Vinapaco Building - 142 Đội Cấn",
    "THCS Thống Nhất",
    "Ngõ 47 Đội Cấn",
    "Ngõ 46 Đội Cấn"
  ]
}