North Carolina Driver License PDF417 API

Decode the PDF417 barcode on the back of a North Carolina driver license or State ID and return normalized AAMVA fields as structured JSON.

Capturing North Carolina License-Back Barcodes Reliably

North Carolina businesses often onboard drivers away from a staffed office. A server-side parser lets the capture application stay lightweight while centralizing error handling and field normalization. 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 North Carolina 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 NC. Upload from the client to your backend, keep the StructOCR key server-side, and request a new image if any barcode row is cut off. The free PDF417 scanner can be used to test non-sensitive samples before integration.

Where This Workflow Fits

  • Regional fleet onboarding: Pre-fill names, license number, dates, and address for regional fleet onboarding while keeping final confirmation in the application.
  • Field-service credentials: Use normalized region NC and available AAMVA fields to reduce transcription in fleet operations, field services, and regional vehicle rental.
  • Vehicle rental prefill: Send unreadable North Carolina barcodes to a retake or review queue instead of saving incomplete identity data.
Need more testing? Create a free account to get 200 free credits (equals 100 Driver License scans).

Decode a North Carolina License Back

Upload a JPG, PNG, or WebP image with the full North Carolina 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=@north-carolina-license-back.jpg"

Technical Specs

  • •Endpoint: POST https://api.structocr.com/v1/driver-license-pdf417
  • •Document scope: Back of a US driver license or State ID 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: NC when encoded in a valid North Carolina record
  • •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 produce explicit 422 responses.
  • •Normalized output: Names, dates, address components, class, restrictions, and endorsements use stable JSON keys when present.
  • •State routing: The normalized region field identifies North Carolina as NC.

Illustrative North Carolina AAMVA Response

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

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "source": "pdf417",
    "country_code": "USA",
    "region": "NC",
    "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
  }
}

Frequently Asked Questions

Can the API decode a North Carolina State ID as well as a driver license?

Yes, when the back contains a usable AAMVA driver-license or identification-card record. The returned type and available optional elements depend on what is encoded.

Does a successful North Carolina PDF417 decode prove the card is genuine?

No. It proves that 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 North Carolina license back in even light. Do not fill missing fields from an uncertain or partially visible barcode.

You May Also Like

Related tutorials, platform guides, and comparisons

Tutorial

Python US Driver License PDF417 API Tutorial

Decode US driver license PDF417 barcodes with Python. Send a license-back image, parse AAMVA fields, and handle unreadable barcode errors safely.

Python · Driver License
Country Tutorial

Arkansas Driver License OCR: Extract Fields with Python

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

Python · Driver License
Country Tutorial

Saudi Arabia Driver License OCR: Extract Fields with Python

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

Python · 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

Canada Driver License OCR with Python SDK

Extract structured fields from a Canada provincial driver licence with the StructOCR Python SDK and FastAPI.

Python · Driver License
Country Tutorial

Philippines Driver License OCR with Node.js SDK

Extract structured fields from a Philippines LTO driver's license with the StructOCR Node.js SDK and TypeScript + Express.

Node.js · Driver License
Country Tutorial

Canada Driver License OCR with Node.js SDK

Extract structured fields from a Canada provincial driver licence with the StructOCR Node.js SDK and TypeScript + Express.

Node.js · Driver License
Country Tutorial

Australia Driver License OCR with Node.js SDK

Extract structured fields from a Australia state or territory driver licence with the StructOCR Node.js SDK and TypeScript + Express.

Node.js · Driver License
Country Tutorial

Philippines Driver License OCR with Python SDK

Extract structured fields from a Philippines LTO driver's license with the StructOCR Python SDK and FastAPI.

Python · Driver License
Country Tutorial

Algeria CNIBE (Biometric ID) OCR Python SDK

Python Tutorial: Automate KYC in Algeria. Extract bilingual text and validate TD1 MRZ from CNIBE (Biometric ID) using StructOCR Python SDK.

Python · cnibe (biometric id)

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