California DMV Digital Signature Verification Errors

Invalid Request Body Format

Returned when the request body cannot be parsed as valid JSON. The HTTP response code is 400 Bad Request.

{
  "errors": {
    "": [
      "Unexpected character encountered while parsing value: @. Path '', line 0, position 0."
    ]
  },
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-1e827e49e2cd3dfc8fa41e5d383f6664-f398cbfa0669fc6b-00"
}

Empty Required Field

Returned when a required field is present in the request but has no value. The success field is false and the error field contains the message.

[
  {
    "serviceId": "19862c3a-513f-4d48-ab36-fa583e8df90a",
    "serviceName": "DMV Digital Signature Verification",
    "serviceDescription": "Verifying Digital Signatures on US DL/ID Documents",
    "error": "Empty Required Field: 'trackString'",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

Invalid trackString Format

Returned when the trackString field is present but the barcode data cannot be parsed (bad scan quality, incorrect format, or corrupted data).

[
  {
    "serviceId": "19862c3a-513f-4d48-ab36-fa583e8df90a",
    "serviceName": "DMV Digital Signature Verification",
    "serviceDescription": "Verifying Digital Signatures on US DL/ID Documents",
    "error": "The 'trackString' field is not valid. Errors: This document has an incorrect offset in header of the 2 subfile;Estimated length is greater than real length of the document",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

Unsupported Jurisdiction

Returned when the document was issued by a state or jurisdiction not currently supported by this service.

[
  {
    "serviceId": "19862c3a-513f-4d48-ab36-fa583e8df90a",
    "serviceName": "DMV Digital Signature Verification",
    "serviceDescription": "Verifying Digital Signatures on US DL/ID Documents",
    "error": "The state 'TX' is not supported for such service",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

Generic Processing Error

Returned when an unexpected error occurs during request processing. If this error persists, contact support.

[
  {
    "serviceId": "19862c3a-513f-4d48-ab36-fa583e8df90a",
    "serviceName": "DMV Digital Signature Verification",
    "serviceDescription": "Verifying Digital Signatures on US DL/ID Documents",
    "error": "An error has occurred while processing your request, please try again later. If this issue persists, please contact support@idscan.net",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]