Washington Driver License & ID Card PDF417 API

Decode the PDF417 barcode on Washington driver licenses and state ID cards into AAMVA JSON, with document_kind to tell licenses from ID cards.

Reading Washington Card Barcodes in Real Workflows

Washington issues standard and enhanced driver licenses and ID cards, and its cannabis stores and tech campuses check large volumes of cards. Enhanced records must still be classified as license or ID. PDF417 error correction recovers some damage, but an application should never invent identity values when the barcode cannot be decoded.

One API for Washington Licenses and ID Cards

Washington cards are issued by the Washington State Department of Licensing (DOL). Licenses and identification cards carry the same AAMVA DL/ID PDF417 barcode on the back. Send the back image to the StructOCR PDF417 API: it decodes the barcode deterministically, normalizes the jurisdiction to WA, and returns document_kind as driver_license or id_card. Test a non-sensitive sample in the free PDF417 scanner. For the printed front of the card, use the Driver License OCR API.

Where This Workflow Fits

  • Cannabis retail age checks: Pre-fill names, dates, and address for cannabis retail age checks and keep final confirmation in your application.
  • Corporate campus visitors: Accept both Washington licenses and state ID cards, and use document_kind where only a license is acceptable.
  • Cross-border travel services: Send unreadable Washington barcodes to a retake or manual review step instead of saving partial identity data.
Need more testing? Create a free account to get 200 free credits (equals 100 Driver License scans).

Decode a Washington Card Back

Upload a JPG, PNG, or WebP image of the full card back. Move out of direct light or tilt the card slightly to remove glare, then upload the original camera photo.

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=@washington-card-back.jpg"

Technical Specs

  • •Endpoint: POST https://api.structocr.com/v1/driver-license-pdf417
  • •Document scope: Back of a Washington driver license or state ID card with an AAMVA PDF417 record
  • •Inputs: JPG, PNG, or WebP; Base64 JSON or multipart upload; maximum 4.5 MB
  • •Cost: 2 credits for a successful decode; processing failures are refunded
  • •Region output: WA when encoded in a valid Washington record; document_kind separates licenses from ID cards
  • •Important: Parsing barcode data does not by itself authenticate the credential or the person presenting it

Key Features

  • •Deterministic source: Returned identity fields come from the decoded barcode payload, not generative guessing.
  • •Retake-safe errors: PDF417_NOT_DECODED and AAMVA_NOT_VALID return explicit 422 responses, with an optional capture_issue hint.
  • •License or ID card: document_kind reports which record the barcode carries; ID cards return null license class, restrictions, and endorsements.
  • •Local demand: Built for cannabis retail, tech-campus visitors, and enhanced-card holders near the border.

Illustrative Washington ID Card Response

This response uses wholly fictional data to show a WA identification card. A license returns document_kind driver_license and its class fields.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "document_kind": "id_card",
    "source": "pdf417",
    "country_code": "USA",
    "region": "WA",
    "document_number": "SAMPLE1234",
    "surname": "SAMPLE",
    "given_names": "ALEX MORGAN",
    "first_name": "ALEX",
    "middle_name": "MORGAN",
    "sex": "X",
    "date_of_birth": "1990-01-15",
    "date_of_issue": "2025-01-15",
    "date_of_expiry": "2030-01-15",
    "address": "100 EXAMPLE AVE",
    "city": "SAMPLE CITY",
    "postal_code": "00000",
    "vehicle_class": null,
    "restrictions": null,
    "endorsements": null,
    "document_discriminator": "SAMPLE-DISCRIMINATOR",
    "issuer_identification_number": null,
    "aamva_version": 10,
    "jurisdiction_version": 0
  }
}

Frequently Asked Questions

Does the API read Washington state ID cards as well as driver licenses?

Yes, when the back of the card carries a usable AAMVA record. The response sets document_kind to id_card for identification cards and driver_license for licenses.

Does a successful Washington decode prove the card is genuine?

No. It proves a usable barcode payload was decoded and parsed. Authenticity, identity, eligibility, and fraud decisions require separate controls.

What should the app do after a 422 response?

Ask for a new photo of the full Washington card back in even light, using the capture_issue hint when present. Do not fill missing fields from an uncertain barcode.

You May Also Like

Related tutorials, platform guides, and comparisons

Country Tutorial

India Driver License OCR: Extract Fields with Python

Extract visible fields from India driver license images into JSON. Map identifiers, names and dates, with a review workflow for incomplete results.

Python · Driver License
Tutorial

Nova Scotia Driver’s Licence & ID Card PDF417 API

Decode AAMVA PDF417 barcodes on Nova Scotia driver’s licences and photo ID cards into JSON with ISO dates, postal codes, and document_kind.

Driver License
Tutorial

FastAPI PDF417 Driver License API

Build an asynchronous Python upload route that decodes US driver license PDF417 barcodes and returns normalized AAMVA JSON with safe retake handling.

Driver License
Country Tutorial

United Arab Emirates Driver License OCR: Extract Fields with Python

Extract visible fields from United Arab Emirates driver license images into JSON. Map identifiers, names and dates, with a review workflow for incomplete results.

Python · Driver License
Country Tutorial

West Virginia Driver License OCR: Extract Fields with Python

Extract visible fields from West Virginia driver license images into JSON. Map identifiers, names and dates, with a review workflow for incomplete results.

Python · Driver License
Country Tutorial

US Driver License OCR with Node.js SDK

Extract structured fields from a United States state-issued driver license with the StructOCR Node.js SDK and TypeScript + Express.

Node.js · Driver License
Country Tutorial

US Driver License OCR with Python SDK

Extract structured fields from a United States state-issued driver license with the StructOCR Python SDK and FastAPI.

Python · Driver License
Country Tutorial

UK Driver License OCR with Node.js SDK

Extract structured fields from a United Kingdom photocard driving licence with the StructOCR Node.js SDK and TypeScript + Express.

Node.js · Driver License
Country Tutorial

UK Driver License OCR with Python SDK

Extract structured fields from a United Kingdom photocard driving licence with the StructOCR Python SDK and FastAPI.

Python · Driver License
Tutorial

West Virginia Driver License & ID Card PDF417 API

Decode the PDF417 barcode on West Virginia driver licenses and state ID cards into AAMVA JSON, with document_kind to tell licenses from ID cards.

Driver License

Technical Comparisons & Integrations

Explore platform integrations and competitive analysis

From tutorial to production in 5 minutes.

You've seen the code. Now get your API key, grab your 200 free credits, and see it work with your own images. No credit card required.

Instant Access Cancel Anytime No Credit Card