Motor Vehicle Report

Motor Vehicle Records originate from a state’s Department of Motor Vehicles, and include information related to a person’s driving history, including driver’s license status and restrictions, as well as violations and convictions. Use MVR reports to evaluate a candidate’s driving history and safety record.

Please note that some convictions, such as driving under the influence, may appear only on MVR reports, and not on criminal searches.

For more information, please see Motor Vehicle Records in the Checkr Help Center.

Operations

Retrieve an existing Motor Vehicle Report

Request

Returns an existing Motor Vehicle Report with the input ID.

The response documented here is the multi-MVR format, returned when the Accept: application/vnd.checkr.multimvr+json header is set (recommended). Without the header the endpoint still works, but returns the legacy format where the license details are flattened onto the top-level object instead of nested under license_reports.

Security

basic_auth

Path

idstringrequired

ID of the Motor Vehicle Report to retrieve.

Acceptstring

Set to application/vnd.checkr.multimvr+json to receive the multi-MVR response format: per-license details (including violations, accidents, endorsements, etc.) are nested under the license_reports array, one entry per license on file, instead of the flattened top-level license fields returned by default.

Value:"application/vnd.checkr.multimvr+json"

curl -i -X GET \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/motor_vehicle_reports/{id}' \
  -H 'Accept: application/vnd.checkr.multimvr+json'

Responses

Motor Vehicle Report details

Bodyapplication/json

idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"

objectstring

Value:"motor_vehicle_report"

uristring(ResourceURI)read-only

URI of the resource.

Example:"/v1/motor_vehicle_reports/539fd88c101897f7cd000007"

statusstring(ScreeningStatus)

Status of the screening.

Enum:"complete""pending"

Example:"complete"

resultstring or null(ScreeningResult)

Result of the screening.

Enum:"clear""consider"

Example:"consider"

assessmentstring or null(AssessmentAttribute)

The assessment for this screening. This field will be non-null only for Assess-enabled accounts. For accounts with Assess enabled, it will be null for reports completed before Assess was enabled, and null for a short time after report completion while the account's Assess rules are applied.

Enum:"eligible""review""escalated"

Example:"eligible"

created_atstring, (date-time)

Time at which the screening was created.

Example:"2014-01-18T12:34:00Z"

completed_atstring, (date-time)

Time at which the screening was completed.

Example:"2014-01-18T12:35:30Z"

turnaround_timeinteger

Number of seconds the screening took to complete, calculated from created_at to completed_at.

Example:90

cancellation_reasonstring or null

See cancellation reasons section for possible values.

Example:"complete_now_customer_requested"

cancellation_reason_descriptionstring or null

See cancellation reasons section for possible values.

Example:"Customer requested Complete Now prior to screening completion"

license_reportsArray of objects

Array of license reports

full_namestring

Candidate’s full name, as listed with the DMV.

Example:"John Alfred Smith"

license_numberstring

Candidate’s driver’s license number.

Example:"F2111132"

license_statestring

Candidate’s driver’s license state of issue.

Example:"CA"

previous_license_numberstring

Candidate’s previous driver’s license number.

Example:"F2111132"

previous_license_statestring

Candidate’s previous driver’s license state of issue.

Example:"CA"

license_statusstring

Status of the license as returned by the DMV if found, or status indicating the license is not found or not available.

Example:"valid, expired, not_found"

license_typestring

Type of the license as returned by the DMV.

Example:"personal, commercial, or non-commercial"

license_classstring

Class of the license as returned by the DMV.

Example:"C"

dobstring, (date)

Date of Birth of the individual the license was issued to as returned by the DMV.

Example:"1980-01-01"

expiration_datestring, (date)

Date on which the license expires.

Example:"2016-07-24"

covid_extensionboolean

Returns true when the MVR report has been automatically adjusted for DMV license expiration date extension. This field will be returned in the response data for impacted reports only.

issued_datestring, (date)

Date on which the license was issued.

Example:"2006-12-03"

first_issued_datestring, (date)

Date on which the license was first issued. Used to determine if the candidate meets minimum experience requirements.

Example:"2000-01-14"

inferred_issued_datestring or null, (date)

Checkr-inferred license issued date based on data returned by the DMV.

Example:null

restrictionsArray of strings

Array of restrictions, as returned by the individual states' DMV.

custom_rulesobject

Object with custom rules applied to generate this MVR.

not_foundboolean

No license found by the DMV matching the candidate's license number/state and PII.

Default:false

experience_failedboolean

If true, the MVR has an unsatisfied StrictExperience rule.

Default:false

typestring

MVR type.

Example:"standard"

privilege_to_drivestring

Displays the validity of the license, as determined by the returned license_status, license_class, and expiration_date. If one or more of these three fields indicates that the license is not valid, privilege_to_drive is invalid.

Enum:"valid""invalid"

Example:"valid"

accidentsArray of objects

Array of Accident objects.

violationsArray of objects

Array of Violation objects.

suspensionsArray of objects

Array of Suspension objects.

Response

{
  "id": "e44aa283528e6fde7d542194",
  "object": "motor_vehicle_report",
  "uri": "/v1/motor_vehicle_reports/539fd88c101897f7cd000007",
  "status": "complete",
  "result": "consider",
  "assessment": "eligible",
  "created_at": "2014-01-18T12:34:00Z",
  "completed_at": "2014-01-18T12:35:30Z",
  "turnaround_time": 90,
  "cancellation_reason": "complete_now_customer_requested",
  "cancellation_reason_description": "Customer requested Complete Now prior to screening completion",
  "license_reports": [
    { … }
  ],
  "full_name": "John Alfred Smith",
  "license_number": "F2111132",
  "license_state": "CA",
  "previous_license_number": "F2111132",
  "previous_license_state": "CA",
  "license_status": "valid, expired, not_found",
  "license_type": "personal, commercial, or non-commercial",
  "license_class": "C",
  "dob": "1980-01-01",
  "expiration_date": "2016-07-24",
  "covid_extension": true,
  "issued_date": "2006-12-03",
  "first_issued_date": "2000-01-14",
  "inferred_issued_date": null,
  "restrictions": [
    "string"
  ],
  "custom_rules": {
    "rule_key_1": { … },
    "rule_key_2": { … }
  },
  "not_found": false,
  "experience_failed": false,
  "type": "standard",
  "privilege_to_drive": "valid",
  "accidents": [
    { … }
  ],
  "violations": [
    { … }
  ],
  "suspensions": [
    { … }
  ]
}