WorkerChecks Business API — Overview #

Who is this for? #

The API is designed for BusinessHub customers who want to integrate background check workflows into their own software — such as an HR platform, onboarding system, or applicant tracking tool.

You will need a developer or technical resource to build and maintain the integration.

What can the API do? #

The API currently supports four core actions:

How does authentication work? #

The API uses short-lived bearer tokens for security. Your system calls the authentication endpoint using your Widget Secret (available in your BusinessHub account settings) and receives a token valid for 24 hours. That token is included in the header of every subsequent API request.

What information comes back from a check? #

Once a check is complete, the result endpoint returns:

• Trạng thái — Pending, In Progress, Completed, or Cancelled
• Result — Clear, Attention Required, or Refer (null if not yet complete)
• Release date — when the result was finalised
• Certificate URL — a secure link to view the full result certificate

What do I need to get started? #

To use the API you will need:

• An active BusinessHub account with Worker Checks
• Contact Worker Checks to activate your API access
• A developer to build and maintain the integration
• Your product ID for the check type you want to submit (we will provide this)

Rate limits #

The result endpoint supports up to 30 requests per minute per account. If you exceed this, requests will return an HTTP 429 error — wait 60 seconds before retrying.