LogoLogo
Sign InCertnCertn Help
Certn API
Certn API
  • Certn API
  • Getting Started
    • Request a demo account
      • Get your access token
      • Understand your general resources
      • Create your first application
      • Retrieve the results
  • Guides
    • Manage your settings
    • Manage your integration users
    • Use the API
      • Get and use an Authorization Token
      • Use webhooks
        • Webhook parameters and example
      • 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
      • Softcheck
      • Social Media Check
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • Settings and packages
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
        • Package settings
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook

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 support@certn.co. ©2023 Certn.

On this page
  • Availability
  • Parameters
  • Report

Was this helpful?

Export as PDF
  1. Guides
  2. Run a check

Employment Reference Check

PreviousEmployment VerificationNextEnhanced Identity Verification

Last updated 1 year ago

Was this helpful?

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

Industry
Availability
Endpoints

Human Resources

Yes

Property Management

Yes

Industry
Availability
Endpoints

Human Resources

Yes

Property Management

Yes

Parameters

Request flag

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

Email:

Phone:

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

Invite parameters

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

  • email

  • employer_questionaire_id

See all available Application parameters

Quickscreen parameters

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

    • first_name

    • last_name

      • Email: email or

      • Phone: phone_number

Example request

{
    "email": "test@certn.co",
    "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": "test.reference@certn.co",
                "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

See all

(min 1)

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

Report field:

proof of consent
🇨🇦
🇺🇸
✅
request_employer_references
request_employer_phone_references
✅
📩
✅
📩
✅
📩
✅
📩
Employment Reference flags
quickscreen
reference_result
information
addresses
employer_references
position_or_property_location
Quickscreen
Invite
Quickscreen
Invite
Find your questionnaire ID number
Quickscreen
Invite
Quickscreen
Invite