--- title: "Candidate checks via Humanforce" slug: "candidate-checks-via-humanforce" tags: ["humanforce"] updated: 2026-05-31T06:12:47Z published: 2026-05-31T06:12:47Z canonical: "docs.checkmate.tech/candidate-checks-via-humanforce" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.checkmate.tech/docs/llms.txt > Use this file to discover all available pages before exploring further. # Candidate checks via Humanforce [Video](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/candidate_checks_via_humanforce.mp4?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) Once the Humanforce integration is set up, you can launch background checks and track their progress without leaving Humanforce. If you haven't set up the integration yet, see [Setting up the Humanforce integration](/v1/docs/setting-up-the-humanforce-integration) before continuing. ## Assign a bundle to a job in Humanforce This step only needs to be completed once per job. 1. In Humanforce, click **Jobs** and navigate to the job you want to run checks for. ![navigate to Jobs view](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/01_humanforce_checks_select_jobs.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Click the ⋮ menu and select **Edit job Details**. ![select Edit Job Details](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/02_humanforce_checks_job_details.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Scroll down to the Checkmate section and set **Does this job require a Checkmate check?** to **Yes**. ![choose Yes](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_humanforce_checks_checkmate_details.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Select the Checkmate bundle you would like to use for this job in the **Select your Checkmate package** dropdown. ![select Checkmate bundle](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_humanforce_checks_select_checkmate_bundle.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Click **Save**. ![click Save](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/05_humanforce_checks_click_save.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) ## Launch checks within Humanforce 1. From the Jobs page, click on the relevant job to open the candidate list. ![select the job](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/06_humanforce_checks_select_job.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. In the **Status** column, click the candidate's current status to open the **Status Change** window. ![click on the status](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/07_humanforce_checks_click_status.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Change the candidate's status to **Checkmate Requested** and click **Save**. ![select Checkmate Requested](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/08_humanforce_checks_checkmate_requested.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) 1. Refresh the page — the candidate status should update to **In Progress**. ![In Progress status](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/09_humanforce_checks_in_progress_status.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) ## Monitor progress Note The **Hide Widget** setting in Checkmate must be toggled off to view check progress and results within Humanforce. To monitor the progress of checks, click on the candidate and select the **Activity** tab. Follow the link to view the candidate details and monitor process. ![Activity tab](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/10_humanforce_checks_candidate_activity_tab.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) The following 3 tabs allow you to view progress and edit candidate details: **Background Checks** - From here you can view the status of the check, add additional checks using the **Add Checks** button and download results when checks are complete. **Candidate** - This tab allows you to update the candidate's details at any time during the background check process. **History** - This tab shows a chronological log of events related to the candidate's background screening process. ![3 Candidate profile tabs](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_widget_monitoring_progress.gif?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) ## View results Once all checks are complete, the candidate status will automatically update to **Checkmate Completed**. Results can be viewed and downloaded via the candidate's **Activity** tab (provided the **Hide Widget** toggle is disabled). Result files can be downloaded via the **Background Checks** tab when the check has been completed. ![View results](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_widget_view_results.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A45%3A23Z&se=2026-11-09T14%3A45%3A23Z&sr=c&sp=r&sig=9CbadceELeOHH1ECk36jnio%2FMW%2FtH9WnYPgrLdOE5Ks%3D) Need help? Contact our support team at [team@checkmate.tech](mailto:team@checkmate.tech) and we'll be happy to assist.