Skip to content
Constaia
us_state_id

US state ID card

Non-driver identity cards issued by the states: AAMVA barcode, expiry 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
Expiry date

They 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 both documents in the same request.

  • Constaia tells you whether the card carries the REAL ID marking.

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 numberdocument_number
  • Issuing stateissuing_state
  • First namefirst_name
  • Middle namemiddle_name
  • Last namelast_name
  • Name suffixname_suffix
  • Date of birthbirth_date
  • Issue dateissue_date
  • Expiry dateexpiry_date
  • Sexsex
  • Heightheight
  • Weightweight
  • Eye coloreye_color
  • Hair colorhair_color
  • Addressaddress
  • Postal codepostal_code
  • REAL ID compliantreal_id_compliant
  • Dddd
  • Organ donororgan_donor
  • Veteranveteran
  • Under 21 untilunder_21_until
  • Federal limits applyfederal_limits_apply
  • Barcode databarcode_data

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.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_state_id",
    "label": "US 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: US 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: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is 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 card required.