us_state_idState ID card
Non-driver ID cards issued by state agencies: AAMVA barcode, expiration and age.
- Category
- Identity
- Country
- United States
- Fields it extracts
- 23 fields
- Cost
- 1 credit
us_state_idspecimen- Document number
- Issuing state
- First name
- Middle name
- Last name
- Name suffix
- Date of birth
- Issue date
- Expiration date
State ID cards are issued by the same agencies as driver licenses and carry the same AAMVA barcode. Constaia reads them with the same rules, so you can accept either one in the same request.
- Accept driver licenses and state IDs together when either one works for your process.
- Constaia tells you whether the card carries the REAL ID marking. You don't need it for age or identity checks unless your process requires it.
What it checks
- PDF417 barcode (AAMVA). The back is decoded and compared with the front.
- National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).
us_dl, us_zip - Postal code. Postal code format of the country.
- Holder. Name, number or date of birth match what you expect.
- Age. Minimum or maximum age from the date of birth.
- Validity. Not expired on the reference date.
- Form I-9. Whether the document belongs to list A, B or C.
B
Fields it extracts
- Document number
document_number - Issuing state
issuing_state - First name
first_name - Middle name
middle_name - Last name
last_name - Name suffix
name_suffix - Date of birth
birth_date - Issue date
issue_date - Expiration date
expiry_date - Sex
sex - Height
height - Weight
weight - Eye color
eye_color - Hair color
hair_color - Address
address - Postal code
postal_code - REAL ID compliant
real_id_compliant - Dd
dd - Organ donor
organ_donor - Veteran
veteran - Under 21 until
under_21_until - Federal limits apply
federal_limits_apply - Barcode data
barcode_data
Where it is used
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@us_state_id_specimen.jpg" \
-F 'options={
"expect": "us_state_id",
"checks": {
"not_expired": true,
"min_age_years": 18
},
"storage": "none"
}'Try it for free in test mode with the file us_state_id_specimen.jpg.
Sample response
Fictitious data. Shortened response.
{
"id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
"object": "analysis",
"status": "completed",
"livemode": false,
"document": {
"type": "us_state_id",
"label": "State ID card",
"confidence": 0.97
},
"verdict": {
"expected": [
"us_state_id"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: State ID card."
}
]
},
"fields": {
"document_number": {
"value": "123 456 789",
"confidence": 0.99,
"validated": true
},
"first_name": {
"value": "TAYLOR",
"confidence": 0.98,
"validated": null
},
"last_name": {
"value": "SAMPLE",
"confidence": 0.97,
"validated": null
},
"birth_date": {
"value": "1988-11-21",
"confidence": 0.96,
"validated": null
},
"sex": {
"value": "F",
"confidence": 0.99,
"validated": null
},
"issuing_state": {
"value": "NY",
"confidence": 0.98,
"validated": null
},
"issue_date": {
"value": "2024-02-02",
"confidence": 0.97,
"validated": null
},
"expiry_date": {
"value": "2032-11-21",
"confidence": 0.96,
"validated": null
},
"real_id_compliant": {
"value": true,
"confidence": 0.99,
"validated": null
}
},
"checks": [
{
"code": "aamva_barcode_matches_front",
"passed": true,
"message": "The PDF417 barcode matches the front."
},
{
"code": "not_expired",
"passed": true,
"message": "Valid on the reference date."
},
{
"code": "min_age_years",
"passed": true,
"message": "The holder meets the minimum age."
}
],
"warnings": [],
"storage": {
"mode": "none",
"file_deleted_at": "2026-09-29T10:00:02Z",
"expires_at": null
},
"usage": {
"credits": 1,
"pages": 2
}
}FAQ
Does Constaia prove that the document is authentic?
No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.
Is a copy of the document kept?
Only if it needs review: then it's kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it's deleted as soon as the analysis ends. You can choose never to keep it.
Other documents
And for the record…
Create your free account and validate your first document in five minutes. No credit card required.