New York Driver License PDF417 API

Capturing New York License-Back Barcodes Reliably

High-volume New York onboarding flows need predictable structured fields without asking staff to retype dense license data. Small mobile previews can also encourage users to crop too close to the barcode. PDF417 error correction can recover some damage, but an application should never invent identity values when the payload cannot be decoded.

Normalized AAMVA Data for New York Workflows

Send the complete back image to the StructOCR PDF417 API. The service decodes the barcode deterministically, parses the record defined by the AAMVA DL/ID standard, and normalizes the jurisdiction to NY. Keep visible padding around all four sides of the PDF417 symbol and upload the original camera image rather than a compressed screenshot. The free PDF417 scanner can be used to test non-sensitive samples before integration.

Where This Workflow Fits

• Delivery driver onboarding: Pre-fill names, license number, dates, and address for delivery driver onboarding while keeping final confirmation in the application.
• Mobility account prefill: Use normalized region NY and available AAMVA fields to reduce transcription in urban mobility, delivery onboarding, and financial account intake.
• Document review queues: Send unreadable New York barcodes to a retake or review queue instead of saving incomplete identity data.

Decode a New York License Back

Upload a JPG, PNG, or WebP image with the full New York PDF417 barcode visible. The SDK tabs show equivalent server-side calls.

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

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

Illustrative New York AAMVA Response

This response uses wholly fictional data to demonstrate the normalized NY shape. Optional elements can be null when they are not encoded.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "source": "pdf417",
    "country_code": "USA",
    "region": "NY",
    "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": "C",
    "restrictions": null,
    "endorsements": null,
    "document_discriminator": "SAMPLE-DISCRIMINATOR",
    "issuer_identification_number": null,
    "aamva_version": 10,
    "jurisdiction_version": 0
  }
}