Canadian DMV Service Errors

This section describes errors specific to the Canadian DMV verification service, in addition to the common errors that apply to all services.

Important

None of these errors below count against your subscription quota

Validation Errors

These errors occur when required field(s) are missing from the request or have an invalid format. You can typically identify the problematic field from the error message. To resolve, verify that all required fields are included in your request with the correct format. You can find all needed fields description here.

Note: Some validation errors may return a different response format with detailed field-specific messages.

Examples of validation errors:

#1. Missing required field

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Required field DriverLicenseNumber is empty",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Required field DateOfBirths is empty",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

#2. Jurisdiction is not a Canadian Jurisdiction or has wrong format

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Jurisdiction XY not found. Check it and try again",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Jurisdiction must be 2-letter abbreviation. Check it and try again",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

{
  "errors": {
    "IssuedBy": [
      "The field IssuedBy must be a string or array type with a maximum length of '2'."
    ]
  },
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-ae125a63a44eaa8268dc72347695f18a-96681059890874ec-00"
}

#3. Driver License Number length doesn't match with Jurisdiction length requirements

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Driver License Number must be up to 6 characters for PE jurisdiction. Check it and try again",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Driver License Number must be up to 7 characters for NB jurisdiction. Check it and try again",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

#4. Driver License Class is too long

Usually, up to 2-character value is printed for the Driver License class. However, some jurisdictions print several classes on the document with commas or spaces between them. You must choose and send one 2-character class per request. Otherwise, the error will be returned. E.g. if you have '5A 5L' classes printed, you must choose one ('5A' or '5L').

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Driver License Class must be up to 6 characters. Check it and try again",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

Processing Errors

These errors occur when the jurisdiction experiences temporary issues on their side. These are typically temporary and resolve automatically. To resolve, we recommend waiting 1-15 minutes and submitting the same request again. These errors do not count against your subscription quota.

#1. Request submitted too soon after previous failure

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Document was already submitted in last 60 seconds. Wait for one minute and try again.",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

#2. Jurisdiction request timeout

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "Jurisdiction did not respond in a timely fashion. The request was closed by timeout. Please, try again later.",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]

Other Errors

Other errors may occur that are not specifically documented above. For these cases, a generic error message is returned. To resolve, we recommend waiting 1-15 minutes and submitting the same request again. These errors do not count against your subscription quota.

If the issue persists, please contact us at support@idscan.net.

[
  {
    "serviceId": "58b76696-75e2-466f-97a2-1b216ed40108",
    "serviceName": "Canadian DMV Verification",
    "serviceDescription": "Canadian Driver License Data Verification",
    "error": "An error has occurred while processing your request, please try again later",
    "success": false,
    "locationId": null,
    "readOnlyAccessLocationIds": null,
    "metadata": {},
    "profiles": []
  }
]