Developer Beta

API Playground

Chọn endpoint, sửa tham số, gửi yêu cầu thật tới Address API v1 và copy mã tương ứng.

RequestPOST /v1/address/history

Body (JSON)

Cần JavaScript để gửi từ trang này; phản hồi bên cạnh là kết quả thật của ví dụ.

ResponseHTTP 200

{
  "apiVersion": "1",
  "status": "beta",
  "data": {
    "address": {
      "input": "Phường 11, Quận 10, TP.HCM",
      "sources": [
        {
          "id": "gso-2025",
          "name": "Danh mục đơn vị hành chính – Tổng cục Thống kê",
          "asOf": "2025-03-01"
        },
        {
          "id": "nq-202-2025",
          "name": "Nghị quyết 202/2025/QH15 và các nghị quyết sắp xếp cấp xã năm 2025",
          "asOf": "2025-07-01"
        },
        {
          "id": "gso-history",
          "name": "Danh mục Tổng cục Thống kê qua các thời kỳ",
          "asOf": "2025-03-01"
        },
        {
          "id": "ubtvqh",
          "name": "Nghị quyết của Ủy ban Thường vụ Quốc hội về sắp xếp đơn vị hành chính",
          "asOf": "2025-03-01"
        }
      ],
      "confidence": {
        "level": "exact",
        "ai": false
      },
      "dataUpdated": "2026-09-30",
      "normalized": "Phường Vườn Lài, Thành phố Hồ Chí Minh",
      "ward": {
        "name": "Phường Vườn Lài",
        "code": "27190",
        "slug": "phuong-vuon-lai"
      },
      "province": {
        "name": "Thành phố Hồ Chí Minh",
        "code": "79",
        "slug": "ho-chi-minh"
      },
      "historical": {
        "oldWard": {
          "name": "Phường 11",
          "code": "27175",
          "slug": "phuong-11"
        },
        "oldDistrict": {
          "name": "Quận 10",
          "code": "771",
          "slug": "quan-10"
        },
        "oldProvince": {
          "name": "Thành phố Hồ Chí Minh",
          "code": "79",
          "slug": "thanh-pho-ho-chi-minh"
        },
        "dissolved": {
          "on": "2025-01-01",
          "by": [
            "1278/NQ-UBTVQH15"
          ]
        },
        "timeline": [
          {
            "from": "2004-08-31",
            "to": "2025-01-01",
            "name": "Phường 11",
            "district": "Quận 10",
            "province": "Thành phố Hồ Chí Minh",
            "event": "nhập vào Phường 10 (Quận 10)",
            "doc": "1278/NQ-UBTVQH15"
          }
        ]
      }
    },
    "dissolved": {
      "on": "2025-01-01",
      "by": [
        "1278/NQ-UBTVQH15"
      ]
    },
    "timeline": [
      {
        "from": "2004-08-31",
        "to": "2025-01-01",
        "name": "Phường 11",
        "district": "Quận 10",
        "province": "Thành phố Hồ Chí Minh",
        "event": "nhập vào Phường 10 (Quận 10)",
        "doc": "1278/NQ-UBTVQH15"
      }
    ],
    "mergedInto": {
      "ward": {
        "name": "Phường Vườn Lài",
        "code": "27190",
        "slug": "phuong-vuon-lai"
      },
      "from": [
        {
          "ward": "Phường 1",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": false
        },
        {
          "ward": "Phường 2",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": false
        },
        {
          "ward": "Phường 4",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": false
        },
        {
          "ward": "Phường 9",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": false
        },
        {
          "ward": "Phường 10",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": false
        },
        {
          "ward": "Phường 11",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": true
        },
        {
          "ward": "Phường 3",
          "district": "Quận 10",
          "province": "Thành phố Hồ Chí Minh",
          "dissolved": true
        }
      ]
    }
  },
  "meta": {
    "requestId": "req-71",
    "tookMs": 52,
    "sources": [
      {
        "id": "gso-2025",
        "name": "Danh mục đơn vị hành chính – Tổng cục Thống kê",
        "asOf": "2025-03-01"
      },
      {
        "id": "nq-202-2025",
        "name": "Nghị quyết 202/2025/QH15 và các nghị quyết sắp xếp cấp xã năm 2025",
        "asOf": "2025-07-01"
      },
      {
        "id": "gso-history",
        "name": "Danh mục Tổng cục Thống kê qua các thời kỳ",
        "asOf": "2025-03-01"
      },
      {
        "id": "ubtvqh",
        "name": "Nghị quyết của Ủy ban Thường vụ Quốc hội về sắp xếp đơn vị hành chính",
        "asOf": "2025-03-01"
      }
    ]
  }
}

cURL

curl -X POST https://tradiachi.com/v1/address/history \
  -H 'content-type: application/json' \
  -d '{"address":"Phường 11, Quận 10, TP.HCM"}'

JavaScript

const res = await fetch('https://tradiachi.com/v1/address/history', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    "address": "Phường 11, Quận 10, TP.HCM"
  }),
});
const { data, error } = await res.json();

Python

import requests

res = requests.post('https://tradiachi.com/v1/address/history', json={
    "address": "Phường 11, Quận 10, TP.HCM"
}, timeout=10)
print(res.json())

PHP

<?php
$ch = curl_init('https://tradiachi.com/v1/address/history');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['content-type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'address' => "Phường 11, Quận 10, TP.HCM",
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
var_dump(json_decode(curl_exec($ch), true));