LogoLogo
Sign InCertnCertn Help
Certn API v 1.0
Certn API v 1.0
  • Certn API v 1.0
  • Getting Started
    • Create a demo account
      • Send your first request
      • Retrieve the results
  • Guides
    • Manage your team
    • Use the API
      • Use an authorization header
      • Use webhooks
      • Get the applicant's consent
    • Run a check
      • Address Reference Check
      • Australia Right To Work Check
      • Basic Disclosure And Barring Service Check
      • Basic Disclosure Scotland Check
      • Canadian Criminal Record Check
      • Credential Verification
      • Credit Check
      • Education Verification
      • Employment Verification
      • Employment Reference Check
      • Enhanced Identity Verification
      • International Criminal Record Check
      • Motor Vehicle Record Check / Driver's Abstract
      • Social Media Check
      • Softcheck
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • General
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook
On this page
  1. Guides
  2. Run a check

Employment Reference Check

PreviousEmployment VerificationNextEnhanced Identity Verification

Last updated 1 year ago

The Certn Group of companies includes Certn, Credence & InterCheck. For educational purposes, these companies are referred to as “Certn” in this website. For questions about any of the aforementioned companies, contact [email protected]. ©2023 Certn.

CtrlK
  • Availability
  • Parameters
  • Report

Phone reference check

A phone reference check includes manually calling your candidate's supplied reference to answer a list of questions and the summary of the reference call is included in your Certn report. Certn has a standard list of questions or the customer can provide their own.

Digital reference check

A digital reference check includes submitting employment reference questionnaires using our standard questions or allows you to supply a customized list of questions to verify the best applicant.

Availability

This check is available in Canada 🇨🇦 and the US 🇺🇸

This check is available for a quickscreen ✅

Industry
Availability
Endpoints

Human Resources

Yes

  • Quickscreen ✅

  • Invite 📩

Property Management

Yes

  • Quickscreen ✅

  • Invite 📩

Industry
Availability
Endpoints

Human Resources

Yes

  • Quickscreen ✅

  • Invite 📩

Property Management

Yes

  • Quickscreen ✅

  • Invite 📩

Parameters

Request flag

Include one of these flags in the body of your request:

Email: request_employer_references

Phone: request_employer_phone_references

Optional flags

Set these flags explicitly, or leave them out to use your team's default settings:

employer_references_years_or_individually

employer_references_years

employer_references_min

employer_references_max

See all Employment Reference flags

Invite parameters

To invite an applicant to complete a screen, include this parameter in the body of your request:

  • email

  • employer_questionaire_id

    • Find your questionnaire ID number

See all available Application parameters

Quickscreen parameters

To complete a quickscreen, include these parameters in the body of your request:

  • information

    • first_name

    • last_name

    • addresses

    • employer_references (min 1)

      • Email: email or

      • Phone: phone_number

  • position_or_property_location

Make sure to obtain the proof of consent from your applicant before running the quickscreen.

Example request

{
    "email": "[email protected]",
    "request_employer_phone_references": true,
    "employer_questionaire_id": "b123b4cd-1a23-1a23-12a3-a123456b7890",
    "information": {
        "first_name": "Andrew",
        "last_name": "McLeod",
        "addresses": [{
                "address": "4412 King Alfred Court",
                "city": "Victoria",
                "province_state": "BC",
                "country": "CA",
                "current": true
            }
        ],
        "employer_references": [{
                "company_name": "Bob's Mechanics",
                "position": "Mechanic",
                "start_date": "2010-01-01",
                "end_date": "2020-12-23",
                "first_name": "Bob",
                "last_name": "Mechanic",
                "reference_job_title": "Head Mechanic",
                "relationship": "Supervisor",
                "email": "[email protected]",
                "phone_number": "12501234567"
            }
        ]
    },
    "position_or_property_location": {
        "address": "Tiffany & Co., 97 Greene St",
        "city": "New York City",
        "county": "New York",
        "province_state": "NY",
        "country": "US",
        "postal_code": "10012",
        "location_type": "Position Location"
    }
}

Report

Report field: reference_result