Background Checks

Background checks verify a person’s identity, history, and qualifications to ensure they meet legal, regulatory, or policy standards. The help docs have more information.

Create Manual Background Check

Create a Background Check record and mark the user as compliant for Background Check requirements.

🔒 Requires Personnel: Create Background Check permission.

Securitybearer
Request
Request Body schema: application/json
required
userId
required
number

The ID of the User for whom the Background Check is being uploaded

url
required
string <uri> <= 768 characters

The URL of the Background Check document or report

filedAt
required
string <date>

The date when this Background Check data was completed.

Responses
201

Created

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action

404

Not Found

409

There is a conflict in the business rules with this request

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

post/background-checks
Request samples
application/json
{}
Response samples
application/json
{
  • "id": 1,
  • "employmentStatus": "CURRENT_EMPLOYEE",
  • "userId": 1,
  • "email": "[email protected]",
  • "createdAt": "2023-01-01T00:00:00.000Z",
  • "updatedAt": "2023-01-01T00:00:00.000Z"
}