Skip to content

Continuous Checks

Continuous Check runs a monthly check for pointers to new records, which may result in a Report. Unlike a Subscription, which generates a full Report at a defined cadence, Continuous Check generates a full Report only if new reportable information is found. For more information, see Continuous Crim: The new standard of safety and Continuous MVR: The new standard in driver safety in the Checkr Help Center.

Use the report.complete webhook to watch for new Reports created for candidates enrolled in Continuous Check. These Reports will list one of the following as the Package within the webhook payload:

  • continuous_check
  • continuous_mvr
  • continuous_mvr_enrollment

Note: These Package names are returned through the Checkr APIs, but may not be used as input. Attempting to create Invitations, Reports, or Subscriptions with these Packages will result in a Package not found error.

Note: It is your legal obligation to manage your list of candidates enrolled in Continuous Check. You must obtain the required evergreen consent before enrolling them, and you must remove them from the service when they begin an Adverse Action process or are removed from your platform. Work with your legal counsel to ensure that your Continuous Check process remains compliant with all applicable laws and regulations.

Note: If your candidate is located outside of the US, they cannot be enrolled in Continuous Check.

Operations

Create a new Continuous Check

Request

Creates a new Continuous Check resource.

Security
basic_auth
Path
candidate_idstringrequired

The Candidate's ID.

Bodyapplication/jsonrequired
typestringrequired

Defines the screening type(s) for this Continuous Check.

Enum:"criminal""mvr"
Example:"criminal"
nodestring

Required for hierarchy-enabled accounts with Nodes.

custom_id of the associated node.

work_locationsArray of objects(WorkLocation)

Required for hierarchy-enabled accounts.

Array of locations described using country, state, and city. When country is not specified defaults to US. State is required for US candidates. Country is required for non-US candidates.

mvr_enrollment_typestring

Applies when type is mvr.

Specifies the Continuous MVR enrollment type. Use commercial for commercial driver's license (CDL) holders. When omitted, Checkr derives the enrollment type from the candidate's most recent completed MVR, or defaults to standard.

Enum:"commercial""standard"
Example:"commercial"
curl -i -X POST \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/candidates/{candidate_id}/continuous_checks' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "criminal",
    "node": "string",
    "work_locations": [
      {
        "country": "US",
        "state": "CA",
        "city": "San Francisco"
      }
    ],
    "mvr_enrollment_type": "commercial"
  }'

Responses

Continuous Check was successfully created

Bodyapplication/json
idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"
objectstringread-only
Value:"continuous_check"
typestring

Type of Continuous Check.

Enum:"criminal""mvr"
Example:"criminal"
created_atstring, (date-time)

Time at which the Continuous Check was created.

Example:"2015-05-14T17:45:34Z"
candidate_idstring

ID of the Candidate enrolled in Continuous Check.

Example:"551564b7865af96a28b13f36"
nodestring

Custom ID of the Node associated with the Continuous Check.

Example:"zpy8orej4r614ize"
work_locationsArray of objects(WorkLocation)

Array of work locations associated with the Continuous Check.

Response
{
  "id": "e44aa283528e6fde7d542194",
  "object": "continuous_check",
  "type": "criminal",
  "created_at": "2015-05-14T17:45:34Z",
  "candidate_id": "551564b7865af96a28b13f36",
  "node": "zpy8orej4r614ize",
  "work_locations": [
    { … }
  ]
}
© Checkr, Inc.