Create a new driver check.
Profile vs inline PII: Submit either a profile_id or inline PII/address fields—not both. Combining profile_id with name fields, driver_license_number, driver_license_state, address, addresses, or other PII returns 400 Bad Request (validation_error: "request must only contain a profile_id, or other fields"). Empty address: {} or addresses: [] count as supplied address parameters and cannot be paired with profile_id.
On inline create (without profile_id), optional address or addresses[] are saved to the new profile.
Prefer addresses[] for new integrations; index 0 is the primary address used when ordering the check. Top-level zip_code takes precedence over zip codes embedded in address fields.
For motor_vehicle_report checks in Washington (WA), only DPPA purposes employment and insurance are supported. If your account is configured with a different DPPA purpose, requests for motor_vehicle_report checks in WA will be rejected. This restriction does not apply to driver_license_status checks.
The request to create a driver check.
Use either inline PII/address fields or profile_id—not both. See the POST /driver_checks operation for details.
Create a driver check by providing PII directly.
First name of the person. Required (with last_name) when not sending full_name.
Last name of the person. Required (with first_name) when not sending full_name.
Either send the full name, or first and last names, but not both. If you send a full name, we will attempt to parse it into first name, middle name(s) and last name. If you already know the first and last names, we suggest sending them.
Date of birth (ISO 8601 date string). Must be a valid date and cannot be in the future. If invalid, the API returns a 400 with a validation_error pointing to /dob.
State that issued the driver license
Optional ZIP code used when ordering the check. Takes precedence over address.zip_code when both are provided. When omitted, the API may use address.zip_code or the zip code stored on the profile (including from addresses[] on inline create). Required for Rhode Island driver_license_status checks.
Primary address for the driver check. The primary address zip code may be used when ordering the check if no top-level zip_code is provided. Prefer addresses for new integrations; when both are provided, address is treated as the primary entry.
On inline create (without profile_id), optional address or addresses[] are saved to the new profile.
Addresses associated with the request. Index 0 is the primary address used when ordering the check.
On inline create, addresses are saved to the new profile.
[ { "street": "123 Main St", "city": "Austin", "state": "TX", "zip_code": "78701", "country": "US" } ]
- Checkr Trust APIhttps://api.checkrtrust.com/v1/driver_checks
curl -i -X POST \
https://api.checkrtrust.com/v1/driver_checks \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"first_name": "Jane",
"last_name": "Doe",
"dob": "1990-01-15",
"driver_license_number": "12345678",
"driver_license_state": "TX",
"check_type": "motor_vehicle_report",
"addresses": [
{
"street": "123 Main St",
"city": "Austin",
"state": "TX",
"zip_code": "78701",
"country": "US"
}
]
}'Created. When the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.
A universally unique identifier (UUID) in standard format.
An ISO 8601 formatted date-time string.
An ISO 8601 formatted date-time string.
Results, or null if not completed. The structure depends on the value of check_type.
A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.
{ "profile_id": "2b8313e8-4efd-45a1-b578-952b8313e890", "id": "2b8313e8-4efd-45a1-b578-952b8313e890", "created_at": "2020-01-01T00:00:00Z", "completed_at": "2020-01-01T00:00:00Z", "results": { "requested_profile": { … }, "passenger": { … } }, "check_type": "driver_license_status", "reference_id": "ref-123" }