Application parameters

This article lists all the parameters available when making PUT or POST calls to the /applicants endpoints.
Invite an applicant
Provide the applicant's email address, along with the appropriate Request flags. All other parameters are optional.
Run a quick screen
Provide the required parameters for each of your checks, along with the appropriate Request flags. Find the required parameters for specific checks in their page under Run a check.
An asterisk (*) next to a parameter name indicates that it's a required parameter within that object. The API will throw an error if the object is present but the parameter is missing.
Main parameters
Parameter
Type
Note
tag
string
Group related applications by tag
email
string
​
phone_number
object (PhoneNumber)
​
information
object (Information)
​
Parameter objects
Address
Parameter
Type
Note
address
string
​
unit
string
​
city *
string
​
province_state *
string
​
country * 
string
​
postal_code *
string
​
rent_or_own
string <enum>
R, O, S 
​
Rent, Own, Staying with friends or family
cost
number
Monthly payment (rent, mortgage, etc.)
start_date
string <date>
​
end_date
string <date> nullable
​
certn_verification
string <enum>
​enums (verification)
verification_notes
string
Notes supplementing the certn_verification field results
address_reference
object (Reference)
​
BaseAddress
Parameter
Type
Note
address
string
​
unit
string
​
city *
string
​
province_state *
string
​
country *
string
​
postal_code
string
​
Contact
Parameter
Type
Note
can_contact
boolean
Can Certn contact this person?
can_contact_after_date
string <date>
​
Conviction
Parameter
Type
Note
offence *
string
Conviction code in the Criminal Code of Canada​
​
date_of_sentence *
string <date>
Conviction date YYYY-MM-DD
court_location *
string
Sentencing court as city, province, country
description *
string
Description of the offense
Credential
Parameter
Type
Note
date_of_certification *
string <date>
YYYY-MM-DD
certification *
string
Certification title
institution *
string
​
description *
string
Description of the certification
current *
boolean
Currently (in the process of) obtaining it: TRUE
Already obtained: FALSE
highest_level
string
Determine the highest level for Certn to verify

Use with credential_verification_level: HIGHEST
Degree
Parameter
Type
Note
degree
string <date>
​
verified
boolean <date> nullable
​
Education
Parameter
Type
Note
institution *
string
​
degree *
object (Degree)
​
current *
boolean
Currently (in the process of) obtaining it: TRUE
Already obtained: FALSE
start_date *
string <date>
YYYY-MM-DD
end_date *
string <date> nullable
YYYY-MM-DD

Not required if current = TRUE
address
object (BaseAddress)
​
highest_level
string
Determine the highest level for Certn to verify

Use with education_verification_level: HIGHEST
Education verification notes
Parameter
Type
Note
certn_verification
string <enum>
​enums (verification)
verification_notes
string
Notes supplementing the certn_verification field results
Employer
Parameter
Type
Note
company_name *
string
​
position *
string
​
income 
number
​
pay_period 
string <enum>
PER_HOUR, PER_MONTH, PER_YEAR, BIWEEKLY, BIMONTHLY
​
Default: PER_YEAR
start_date
string <date>
​
end_date
string <date> nullable
​
contact_first_name
string
First name of the employer reference 

Used for reference checks
contact_last_name
string
Last name of the employer reference

Used for reference checks
contact_position
string
Position of the employer reference

Used for reference checks
contact_email
string
Email for the employer reference

Used for reference checks
contact_phone
string
Phone number for the employer reference

Used for reference checks
can_contact
boolean
Can Certn contact this reference?

Used for reference checks
Employer verification notes
Parameter
Type
Note
certn_verification
string <enum>
​enums (verification)
verification_notes
string
Notes supplementing the certn_verification field results
Email
Parameter
Type
Note
address
string
Required for email references
EnhancedIdentityVerification
Parameter
Type
Note
id_country *
string
​ISO country code​
id_type *
string <enum>
PASSPORT, DRIVING_LICENSE, ID_CARD, VISA
face_image *
string
Base64 encoded selfie. Accepts JPEG or PNG. 
​
Size: <10MB
Sides: <8000 pixels per side longest >300 pixels
id_frontside_image *
string
Base64 encoded image of the ID's front.
Accepts JPEG or PNG.
​
Size: <10MB
Sides: <8000 pixels per side, longest >300 pixels
id_backside_image
string
Base64 encoded image of the ID's back.
Accepts JPEG or PNG.
​
Size: <10MB
Sides: <8000 pixels per side, longest >300 pixels
Information
Parameter
Type
Note
first_name *
string
​
middle_name
string
​
last_name *
string
​
last_name_at_birth
string
​
former_names
string
​
alias
string
​
date_of_birth *
string <date>
YYYY-MM-DD
phone_number
string	
Non-numerical characters will be removed
sin_ssn
string
Social Insurance Number / Social Security Number
gender
string <enum>
M, F
Required for Canadian Criminal Record Checks​
birth_city
string
​
birth_province_state
string
​ISO province or state code​
birth_other_province_state
string
Province or state if outside Canada or US
birth_country
string
​ISO country code​
license_number
string
​
license_valid
boolean
​
license_province_state
string
​ISO province or state code 
license_other_country
boolean nullable
Is the license from the same country as the applicant's residential country?
license_type
string <enum>
CA, US, INTERNATIONAL, NONE
cover_letter
string
​
Name
Parameter
Type
Note
first_name *
string
​
middle_name
string
​
last_name *
string
​
PhoneNumber
Parameter
Type
Note
phone_type
string <enum>
NONE, WORK, HOME, CELL, OTHER
number
string
​
country
string
​ISO country code​
Reference
Parameter
Type
Note
email
object (Email)
​
phone_number
object (PhoneNumber)
​
name
object (Name)
​
contact
object (Contact)
​