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
Please, note:
- 'Undefined' overall status is set in
serviceVerificationResultobject when error occurs - Error message is set in
errorobject andsuccessfield is false
[
{
"requestDetail": {
"requestLogId": 11111233,
"requestDateUtc": "2025-10-08T08:15:21.7626481Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Required field DriverLicenseNumber is empty",
"traceId": "00-ad23a2b26a1832f69170f5c6c7f6b9e5-b52e28aaba15218c-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
#2. Jurisdiction is not a Canadian Jurisdiction or has wrong format
[
{
"requestDetail": {
"requestLogId": 55554115,
"requestDateUtc": "2025-10-01T08:20:45.125441Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Jurisdiction XY not found. Check it and try again",
"traceId": "00-f4efeb0c12666vfd27d5a2e56e789a57-99dc64fb9bas5389-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
[
{
"requestDetail": {
"requestLogId": 44444116,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Jurisdiction must be 2-letter abbreviation. Check it and try again",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
{
"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
[
{
"requestDetail": {
"requestLogId": 44444116,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Driver License Number must be up to 6 characters for PE jurisdiction. Check it and try again",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
[
{
"requestDetail": {
"requestLogId": 44444116,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Driver License Number must be up to 7 characters for NB jurisdiction. Check it and try again",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
#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').
[
{
"requestDetail": {
"requestLogId": 44444116,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Driver License Class must be up to 6 characters. Check it and try again",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
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
[
{
"requestDetail": {
"requestLogId": 44444116,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Document was already submitted in last 60 seconds. Wait for one minute and try again.",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
#2. Jurisdiction request timeout
[
{
"requestDetail": {
"requestLogId": 44444125,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "Jurisdiction did not respond in a timely fashion. The request was closed by timeout. Please, try again later.",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]
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.
[
{
"requestDetail": {
"requestLogId": 44444125,
"requestDateUtc": "2025-09-03T08:21:34.3946117Z"
},
"metadata": {},
"success": false,
"error": {
"message": "An error has occurred while processing your request, please try again later",
"traceId": "00-2f223fe7671p5a26634a31cs491a5829-b50bef7522c66922-00"
},
"service": {
"id": "58b76696-75e2-466f-97a2-1b216ed40108",
"name": "Canadian DMV Verification",
"description": "Canadian Driver License Data Verification",
"isMultipleProfiles": false
},
"location": {
"locationId": null,
"readOnlyAccessLocationIds": null
},
"serviceVerificationResult": {
"statusCode": 3,
"statusString": "Undefined"
},
"profiles": null
}
]