Đọc mã QR căn cước (CCCD) API

Đọc mã QR trên thẻ căn cước gắn chip (CCCD / căn cước) từ chuỗi hoặc ảnh: số định danh, họ tên, ngày sinh, giới tính, nơi cư trú, ngày cấp, kèm kiểm tra.

Tham số

Ví dụ

curl -X POST "https://apibox.io.vn/v1/cccd-qr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"qr":"079099012345|272345678|Nguyễn Văn An|15081999|Nam|123 Lê Lợi, Phường Bến Thành, Quận 1, TP. Hồ Chí Minh|20042021"}'

const res = await fetch('https://apibox.io.vn/v1/cccd-qr', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "qr": "079099012345|272345678|Nguyễn Văn An|15081999|Nam|123 Lê Lợi, Phường Bến Thành, Quận 1, TP. Hồ Chí Minh|20042021"
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/cccd-qr",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"qr": "079099012345|272345678|Nguyễn Văn An|15081999|Nam|123 Lê Lợi, Phường Bến Thành, Quận 1, TP. Hồ Chí Minh|20042021"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/cccd-qr');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"qr":"079099012345|272345678|Nguyễn Văn An|15081999|Nam|123 Lê Lợi, Phường Bến Thành, Quận 1, TP. Hồ Chí Minh|20042021"}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "source": "text",
  "valid": true,
  "errors": [],
  "warnings": [],
  "id_number": "079099012345",
  "old_id_number": "272345678",
  "full_name": "Nguyễn Văn An",
  "date_of_birth": "1999-08-15",
  "sex": "male",
  "address": "123 Lê Lợi, Phường Bến Thành, Quận 1, TP. Hồ Chí Minh",
  "issue_date": "2021-04-20",
  "name_parts": {
    "family_name": "Nguyễn",
    "middle_name": "Văn",
    "given_name": "An",
    "unaccented": "NGUYEN VAN AN"
  },
  "number_details": {
    "province_code": "079",
    "province": "TP. Hồ Chí Minh",
    "province_since_2025": "TP. Hồ Chí Minh",
    "sex": "male",
    "century_digit": 0,
    "birth_year": 1999,
    "serial": "012345"
  },
  "validity": {
    "valid_until": "2024-08-15",
    "lifetime": false,
    "expired": true,
    "rule": "Renew at 14, 25, 40 and 60; a card issued within 2 years before one of these ages stays valid until the next one (Luật Căn cước 2023, Điều 21)."
  },
  "address_parsed": {
    "format": "old (before 07/2025)",
    "matched": true,
    "result": {
      "ward": "Phường Bến Thành",
      "ward_code": "26743",
      "province": "Thành phố Hồ Chí Minh",
      "province_code": "79",
      "postal_code": "71009",
      "full_address": "123 Lê Lợi, Phường Bến Thành, Thành phố Hồ Chí Minh"
    }
  },
  "note": "Parsed from the QR text only: this does not prove the card is genuine (use NFC chip reading / C06 verification for eKYC). Nothing is stored or logged."
}

Ứng dụng

• Khai báo lưu trú khách sạn, nhà trọ từ thẻ căn cước
• Rút ngắn form đăng ký khách hàng (ngân hàng, SIM, phòng khám)
• Đối chiếu thông tin nhập tay với thẻ
• Phát hiện thẻ căn cước hết hạn khi làm thủ tục

Hỏi đáp

API liên quan