US State ID Card PDF417 Barcode API

Non-Drivers Still Need to Be Checked In

Millions of US adults hold a state identification card instead of a driver license, often older customers, city residents who do not drive, and younger applicants. States print the same AAMVA PDF417 barcode on the back of these cards. A scanning flow built only around licenses either rejects them or stores them as licenses with blank class and endorsement fields.

Same Endpoint, Explicit Document Kind

Upload the card back to the PDF417 API. StructOCR decodes the barcode deterministically, parses the AAMVA DL/ID record, and returns document_kind: "id_card" with the issuing state in region. Licenses return driver_license. Try a non-sensitive sample in the free PDF417 scanner.

Where ID Card Barcodes Show Up

• Age-restricted retail: Verify date of birth from state ID cards at alcohol, tobacco, and cannabis counters with the same flow as licenses.
• Healthcare and visitor intake: Pre-fill patient or visitor name, date of birth, and address from either card type.
• Fintech and telecom onboarding: Accept the ID many applicants actually carry while recording the correct document type for KYC review.

Decode a State ID Card Back

Upload a JPG, PNG, or WebP image with the full PDF417 barcode visible. Language tutorials show the same call with document_kind handling.

Prerequisite: A server-side StructOCR API key and a clear image of the complete card back

curl -X POST https://api.structocr.com/v1/driver-license-pdf417 \
  -H "x-api-key: $STRUCTOCR_API_KEY" \
  -F "file=@state-id-back.jpg"

Illustrative State ID Card Response

This response uses wholly fictional data. Some states fill vehicle_class on ID cards with their own placeholder, so rely on document_kind instead.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "document_kind": "id_card",
    "source": "pdf417",
    "country_code": "USA",
    "region": "NY",
    "document_number": "SAMPLEID123",
    "surname": "SAMPLE",
    "given_names": "ALEX MORGAN",
    "first_name": "ALEX",
    "middle_name": "MORGAN",
    "name_suffix": null,
    "sex": "F",
    "date_of_birth": "1990-01-15",
    "date_of_issue": "2025-01-15",
    "date_of_expiry": "2033-01-15",
    "address": "100 EXAMPLE AVE",
    "city": "SAMPLE CITY",
    "postal_code": "10001",
    "vehicle_class": null,
    "restrictions": null,
    "endorsements": null,
    "height": null,
    "eye_color": null,
    "document_discriminator": "SAMPLE-DISCRIMINATOR",
    "issuer_identification_number": "636000",
    "aamva_version": 10,
    "jurisdiction_version": 0
  }
}