Read the QR Code of a Vietnamese ID Card (CCCD) Online

Parse the QR code of a Vietnamese chip ID card (CCCD / căn cước) from its text or a photo: ID number, name, birth date, sex, address, issue date, checks.

Result

Press “Run” to see the result.

The QR code printed on Vietnamese chip ID cards (CCCD gắn chip since 2021, thẻ căn cước since 07/2024) holds one line of text separated by |: the 12-digit personal ID number, the old 9-digit CMND number (may be empty), full name, date of birth (ddmmyyyy), sex, place of residence and issue date. Send that text as qr, or a photo of the code as image (PNG / JPEG, the QR is read on the server), and get clean JSON with ISO dates.

The 12-digit number is checked against the card itself: province of registration (with the province it belongs to since the 2025 merger), the sex / century digit and the two birth-year digits must agree with the printed date of birth and sex. The name is split into family, middle and given names, the address is matched to the current wards and provinces, and the validity is computed from the renewal ages 14, 25, 40 and 60 of the Law on Identification 2023 (a card issued within 2 years before one of these ages stays valid until the next one).

This reads what the QR says; it does not prove the card is genuine (use the NFC chip for eKYC). The data is personal: it is processed in memory only, never stored and never logged.

Use this in your code

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));

API documentation → Get a free API key

FAQ

Is the card verified with the police database?

No. Only the QR content and the structure of the number are checked; genuine verification needs the NFC chip or the C06 service.

Which cards are supported?

Chip CCCD cards (2021) and the new identity cards (căn cước, 2024). Old barcoded CCCD and 9-digit CMND cards have no such QR code.

Is my data stored?

No. Requests are processed in memory, nothing is written to logs, caches or databases.