Employment History Checks
What is possible with an Employment History Check?
This check will confirm whether the candidate has worked for the organisation stated. Using the data provided by either the client or the candidate, Verifile will research:
- Employer’s name and address
- Period of employment
- Position held
- Reason for leaving
- Disciplinary action taken against the candidate
- Would the employer re-employ the candidate
- Absence, salary and a number of other questions
Structure of the check
There are two Employment History checks listed by the API and have the name:
- EmploymentHistoryUK
- EmploymentHistoryWorldwide
Both are fundamentally the same, with the exception that Worldwide has an extra field of CheckEmploymentCountry.
A lot of the fields available depend on the employment status that is chosen for the field CheckEmploymentStatus. The option chosen for this field affects which fields are mandatory.
Employment History check fields
Field Name | UI Label | Description | Type | Min | Max | Mandatory | Value Set |
---|---|---|---|---|---|---|---|
CheckEmploymentCountry | Country | The country for which the check applies | String | Yes, for Worldwide check | country | ||
CheckEmploymentStartDate | Employment dates | The date the applicant started their employment | String (date) | Yes | |||
CheckEmploymentFinishDate | Employment dates | The date the applicant finished their employment | String (date) | No, but if left blank it implies employment is ongoing | |||
CheckEmploymentRecentPosition | Job title | The candidate's previous job role | String | 100 | Yes | ||
CheckEmploymentSalary | Salary | The candidate’s salary | String | 50 | No | ||
CheckEmploymentLocation | Branch/Department | The area of the business the candidate worked | String | 100 | No | ||
CheckEmploymentPayrollNumber | Payroll/employee number | The payroll number within their employment | String | 100 | No | ||
CheckEmploymentNotes | Notes | Any pertinent data not covered by the other fields | String | 500 | No | ||
CheckEmploymentContactEmployer | May we contact this employer? | Establishes when Verifile can contact the employer | String | Yes | employmentcontactemployer | ||
CheckEmploymentContactEmployerContactDate | Contact from | A date from which Verifile may contact the employer | String (date) | Yes | |||
CheckEmploymentDoNotContactReason | Please provide reasons for your decision | The reason the applicant doesn’t want their employer to be contacted | String | 2 | 256 | If CheckEmployment |
|
CheckEmploymentCandidateReasonForLeaving | Reason for leaving | The candidates reason for leaving this employment | String | if CheckEmployment |
employmentreasonforleaving | ||
CheckEmploymentCandidateReasonForLeavingOther | Details about Reason for leaving | The candidates reason for leaving this employment | String | 2 | 512 | If CheckEmployment |
|
CheckEmploymentStatus | Employment Status | The kind of employment to be checked | String | Yes | employmentstatus | ||
If CheckEmploymentStatus is Self_employed_directly | |||||||
CheckEmploymentSelfEmployedStatus | How did you trade | The type of self-employment for self-employed applicants | String | Yes | selfemploymentstatus | ||
If CheckEmployment |
|||||||
CheckEmploymentSelfEmployedCompanyRegistrationNo | Registration number of company | To help identify the company in question | String | 2 | 32 | Yes | selfemploymentstatus |
CheckEmploymentSelfEmployedCompanyCountry | Country your company was registered in | To identify the country in which the company was registered | String | Yes | country | ||
If CheckEmploymentStatus is Employed_directly, Employed_agency, Voluntary_role or Internship | |||||||
Or CheckEmploymentStatus is Self_employed_directly and IsSelfEmployedThroughOwnCompany is ThroughMyOwnCompany | |||||||
CheckEmploymentEmployer | Various | Employers or Agents name or the Company name | String | 2 | 100 | Yes | |
If CheckEmploymentEmployer is Employed_directly, Voluntary_role and Internship | |||||||
ContactDetails | Contact Details | Contact details for the employer | Object | Yes | |||
ContactDetails/ CheckEmploymentContactName |
Contact name | A contact name for the previous employer | Name | No | |||
ContactDetails/ CheckEmploymentContactEmail |
Email Address | The contact email address of the organisation | String (email) | 7 | 50 | No | |
ContactDetails/ CheckEmploymentContactWebsite |
Website address | Website address of the organisation | String | 2 | 50 | No | |
ContactDetails/ CheckEmploymentContactTelephoneNumber |
Telephone Number | The contact telephone of the organisation | String (telephone) | 2 | 50 | No | |
ContactDetails/ CheckEmploymentContactFaxNumber |
Fax Number | The contact fax of the organisation | String (telephone) | 2 | 50 | No | |
ContactDetails/ CheckEmploymentContactAddress |
Address | The contact address of the organisation | Address | No | |||
ContactDetails/ CheckEmploymentContactCompanyName |
Company Name | The company name of the organisation | String | 500 | No | ||
If the CheckEmploymentEmployer value is Self_employed_directly | |||||||
EmployedDirectlyForClient/ Client |
The client that employed the candidate | Object | Yes | ||||
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientCompany |
Name of client company worked for | The name of the organisation | String | 100 | No | ||
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientName |
Contact name at company worked for | The contact name of the person at the organisation | Name | No | |||
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientEmail |
Email Address | The contact email address of the organisation | String (email) | 7 | 50 | No | |
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientWeb |
Website address | The contact website address of the organisation | String | 2 | 50 | No | |
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientTel |
Telephone Number | The contact telephone of the organisation | String (telephone) | 2 | 50 | No | |
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientFax |
Fax Number | The contact fax number of the organisation | String (telephone) | 2 | 50 | No | |
EmployedDirectlyForClient/ Client/ CheckEmploymentContactClientAddress |
Address | The contact address of the organisation | Address | No | |||
EmployedDirectlyForClient/ Management |
The candidate's management company | Object | Yes | ||||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementCompany |
Name of management company | The name of the organisation | String | 100 | No | ||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementName |
Contact Name | The contact name of the person at the organisation | Name | No | |||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementEmail |
Email Address | The contact email address of the organisation | String (email) | 50 | No | ||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementWebsite |
Website address | The contact website address of the organisation | String | 50 | No | ||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementTel |
Telephone Number | The contact telephone of the organisation | String (telephone) | 50 | No | ||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementFax |
Fax Number | The contact fax number of the organisation | String (telephone) | 50 | No | ||
EmployedDirectlyForClient/ Management/ CheckEmploymentContactManagementAddress |
Address | The contact address of the organisation | Address | No | |||
EmployedDirectlyForClient/ Accountant |
The candidate's company accountant | Object | Yes | ||||
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantFirm |
Name of accountancy firm | The name of the organisation | String | 100 | No | ||
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantName |
Contact Name | The contact name of the person at the organisation | Name | No | |||
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantEmail |
Email Address | The contact email address of the organisation | String (email) | 50 | No | ||
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantWeb |
Website address | The contact website address of the organisation | String | 50 | No | ||
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantTel |
Telephone Number | The contact telephone of the organisation | String (telephone) | 2 | 50 | No | |
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantFax |
Fax Number | The contact fax number of the organisation | String (telephone) | 2 | 50 | No | |
EmployedDirectlyForClient/ Accountant/ CheckEmploymentContactAccountantAddress |
Address | The contact address of the organisation | Address | No |
Candidate entry order
A Typical example of a candidate entry order for an Employment History check.
Request
"CheckGroups": [
{
"Quantity": 1,
"CheckTypeId": "EmploymentHistoryUK"
}
]
Response
"Checks": [
{
"CheckState": {
"StateDescription": "Awaiting candidate entry"
},
"Id": "10001",
"Comment": "",
"CheckType": "EmploymentHistoryUK"
}
]
Client entry order
A typical example of a client entry order for an Employment History check, where the checkEmploymentStatus is Employed_directly.
Request
"Checks": [
{
"ContactDetails": {
"CheckEmploymentContactName": {
"Title": "Mr",
"FirstName": "John",
"MiddleNames": "Alan",
"LastName": "Smith"
},
"CheckEmploymentContactAddress": {
"BusinessName": "The Company",
"HouseNumber": "400",
"StreetName": "Station Road",
"Town": "Bedford",
"County": "Bedfordshire",
"State": "England",
"Postcode": "MK1 0AA",
"Country": "GB"
},
"CheckEmploymentContactTelephoneNumber": "0123456789",
"CheckEmploymentContactFaxNumber": "023456789",
"CheckEmploymentContactEmail": "api@verifile.co.uk",
"CheckEmploymentContactWebsite": "www.verifile.co.uk",
"CheckEmploymentContactCompanyName": "The Company"
},
"CheckEmploymentStatus": "Employed_directly",
"CheckEmploymentRecentPosition": "Businessman",
"CheckEmploymentContactEmployer": "Contact_from",
"CheckEmploymentContactEmployerContactDate": "2017-12-01",
"CheckEmploymentDoNotContactReason": "they don't know he's leaving",
"CheckEmploymentPayrollNumber": "11145896",
"CheckEmploymentSalary": "45000",
"CheckEmploymentNotes": null,
"CheckEmploymentStartDate": "2010-01-02",
"CheckType": "EmploymentHistoryUK"
}
]
Response
"Checks": [
{
"ContactDetails": {
"CheckEmploymentContactName": {
"FullName": "Mr John Alan Smith"
},
"CheckEmploymentContactAddress": {
"AddressString": "The Company 400 Station Road Bedford Bedfordshire England MK1 0AA GB"
},
"CheckEmploymentContactTelephoneNumber": "0123456789",
"CheckEmploymentContactFaxNumber": "023456789",
"CheckEmploymentContactEmail": "api@verifile.co.uk",
"CheckEmploymentContactWebsite": "www.verifile.co.uk",
"CheckEmploymentContactCompanyName": "The Company"
},
"EmployedDirectlyForClient": {
"Accountant": {
"CheckEmploymentContactAccountantName": { "FullName": "" },
"CheckEmploymentContactAccountantAddress": { "AddressString": "" },
"CheckEmploymentContactAccountantFirm": "",
"CheckEmploymentContactAccountantTel": "",
"CheckEmploymentContactAccountantFax": "",
"CheckEmploymentContactAccountantEmail": "",
"CheckEmploymentContactAccountantWeb": ""
},
"Management": {
"CheckEmploymentContactManagementName": { "FullName": "" },
"CheckEmploymentContactManagementAddress": { "AddressString": "" },
"CheckEmploymentContactManagementCompany": "",
"CheckEmploymentContactManagementTel": "",
"CheckEmploymentContactManagementFax": "",
"CheckEmploymentContactManagementEmail": "",
"CheckEmploymentContactManagementWeb": ""
},
"Client": {
"CheckEmploymentContactClientName": { "FullName": "" },
"CheckEmploymentContactClientAddress": { "AddressString": "" },
"CheckEmploymentContactClientCompany": "",
"CheckEmploymentContactClientTel": "",
"CheckEmploymentContactClientFax": "",
"CheckEmploymentContactClientEmail": "",
"CheckEmploymentContactClientWeb": ""
}
},
"CheckEmploymentStatus": "Employed_directly",
"CheckEmploymentSelfEmployedStatus": "",
"CheckEmploymentSelfEmployedCompanyRegistrationNo": "",
"CheckEmploymentSelfEmployedCompanyCountry": "",
"CheckEmploymentEmployer": "",
"CheckEmploymentRecentPosition": "Businessman",
"CheckEmploymentContactEmployer": "Contact_from",
"CheckEmploymentContactEmployerContactDate": "2017-12-01",
"CheckEmploymentDoNotContactReason": "they don't know he's leaving",
"CheckEmploymentLocation": "",
"CheckEmploymentPayrollNumber": "11145896",
"CheckEmploymentCandidateReasonForLeaving": "",
"CheckEmploymentCandidateReasonForLeavingOther": "",
"CheckEmploymentSalary": "45000",
"CheckEmploymentNotes": "",
"CheckEmploymentStartDate": "2010-01-02",
"CheckEmploymentFinishDate": "",
"CheckType": "EmploymentHistoryUK",
"CheckState": { "StateDescription": "Application" },
"Id": "10001",
"Comment": ""
}
]
A typical example of a client entry order for an Employment History check, where the checkEmploymentStatus is Self_employed_directly.
Request
"Checks": [
{
"ContactDetails": {
"CheckEmploymentContactName": {
"Title": "Mr",
"FirstName": "John",
"MiddleNames": "Alan",
"LastName": "Smith"
},
"CheckEmploymentContactAddress": {
"BusinessName": "The Agency",
"HouseNumber": "1",
"StreetName": "Station Road",
"Town": "Bedford",
"County": "Bedfordshire",
"State": "England",
"Postcode": "MK1 0AA",
"Country": "GB"
},
"CheckEmploymentContactTelephoneNumber": "0123456789",
"CheckEmploymentContactFaxNumber": "023456789",
"CheckEmploymentContactEmail": "api@verifile.co.uk",
"CheckEmploymentContactWebsite": "www.verifile.co.uk",
},
"CheckEmploymentStatus": "Employed_agency",
"CheckEmploymentEmployer": "The Agency",
"CheckEmploymentRecentPosition": "Architect",
"CheckEmploymentContactEmployer": "Contact_from",
"CheckEmploymentContactEmployerContactDate": "2017-12-30",
"CheckEmploymentDoNotContactReason": "Closed over Christmas",
"CheckEmploymentPayrollNumber": "11123589",
"CheckEmploymentSalary": "88000",
"CheckEmploymentNotes": null,
"CheckEmploymentStartDate": "2017-01-02",
"CheckEmploymentFinishDate": "2017-12-02",
"CheckType": "EmploymentHistoryUK"
}
]
Response
"Checks": [
{
"ContactDetails": {
"CheckEmploymentContactName": {
"FullName": "Mr John Alan Smith"
},
"CheckEmploymentContactAddress": {
"AddressString": "The Agency 1 Station Road Bedford Bedfordshire England MK1 0AA GB"
},
"CheckEmploymentContactTelephoneNumber": "0123456789",
"CheckEmploymentContactFaxNumber": "023456789",
"CheckEmploymentContactEmail": "api@verifile.co.uk",
"CheckEmploymentContactWebsite": "www.verifile.co.uk",
"CheckEmploymentContactCompanyName": ""
},
"EmployedDirectlyForClient": {
"Accountant": {
"CheckEmploymentContactAccountantName": { "FullName": "" },
"CheckEmploymentContactAccountantAddress": { "AddressString": "" },
"CheckEmploymentContactAccountantFirm": "",
"CheckEmploymentContactAccountantTel": "",
"CheckEmploymentContactAccountantFax": "",
"CheckEmploymentContactAccountantEmail": "",
"CheckEmploymentContactAccountantWeb": ""
},
"Management": {
"CheckEmploymentContactManagementName": { "FullName": "" },
"CheckEmploymentContactManagementAddress": { "AddressString": "" },
"CheckEmploymentContactManagementCompany": "",
"CheckEmploymentContactManagementTel": "",
"CheckEmploymentContactManagementFax": "",
"CheckEmploymentContactManagementEmail": "",
"CheckEmploymentContactManagementWeb": ""
},
"Client": {
"CheckEmploymentContactClientName": { "FullName": "" },
"CheckEmploymentContactClientAddress": { "AddressString": "" },
"CheckEmploymentContactClientCompany": "",
"CheckEmploymentContactClientTel": "",
"CheckEmploymentContactClientFax": "",
"CheckEmploymentContactClientEmail": "",
"CheckEmploymentContactClientWeb": ""
}
},
"CheckEmploymentStatus": "Employed_agency",
"CheckEmploymentSelfEmployedStatus": "",
"CheckEmploymentSelfEmployedCompanyRegistrationNo": "",
"CheckEmploymentSelfEmployedCompanyCountry": "",
"CheckEmploymentEmployer": "The Agency",
"CheckEmploymentRecentPosition": "Architect",
"CheckEmploymentContactEmployer": "Contact_from",
"CheckEmploymentContactEmployerContactDate": "2017-12-30",
"CheckEmploymentDoNotContactReason": "Closed over Christmas",
"CheckEmploymentLocation": "",
"CheckEmploymentPayrollNumber": "11123589",
"CheckEmploymentCandidateReasonForLeaving": "",
"CheckEmploymentCandidateReasonForLeavingOther": "",
"CheckEmploymentSalary": "88000",
"CheckEmploymentNotes": "",
"CheckEmploymentStartDate": "2017-01-02",
"CheckEmploymentFinishDate": "2017-12-02",
"CheckType": "EmploymentHistoryUK",
"CheckState": { "StateDescription": "Application" },
"Id": "10001",
"Comment": ""
}
]
A typical example of a client entry order for an Employment History check, where the checkEmploymentStatus is Self_employed_directly.
Request
"Checks": [
{
"EmployedDirectlyForClient": {
"Accountant": {
"CheckEmploymentContactAccountantName": {
"Title": "Mr",
"FirstName": "John",
"MiddleNames": "Alan",
"LastName": "Smith"
},
"CheckEmploymentContactAccountantAddress": {
"HouseNumber": "11",
"StreetName": "Zala iela",
"Town": "Bauska",
"State": "Bauskas novads",
"Postcode": "3901",
"Country": "LV"
},
"CheckEmploymentContactAccountantFirm": "Prime Accounts",
"CheckEmploymentContactAccountantTel": "0123234234",
"CheckEmploymentContactAccountantFax": "023434565464",
"CheckEmploymentContactAccountantEmail": "api@Verifile.co.uk",
"CheckEmploymentContactAccountantWeb": "www.verifile.co.uk"
},
"Management": {
"CheckEmploymentContactManagementName": {
"Title": "Mrs",
"FirstName": "Joanne",
"LastName": "Steinberg"
},
"CheckEmploymentContactManagementAddress": {
"HouseNumber": "20906",
"StreetName": "Harvest Hill Ln",
"Town": "Houston",
"County": "Harris",
"State": "Texas",
"Postcode": "77073-3127",
"Country": "US"
},
"CheckEmploymentContactManagementCompany": "Managers 'R' US",
"CheckEmploymentContactManagementTel": "0123453453453",
"CheckEmploymentContactManagementFax": "02334634634",
"CheckEmploymentContactManagementEmail": "api@verifile.co.uk",
"CheckEmploymentContactManagementWeb": "werifile.co.uk"
},
"Client": {
"CheckEmploymentContactClientName": {
"Title": "Ms",
"FirstName": "Emma",
"LastName": "Happen"
},
"CheckEmploymentContactClientAddress": {
"HouseNumber": "222",
"StreetName": "Station Road",
"Town": "Bedford",
"County": "Bedfordshire",
"State": "England",
"Postcode": "MK1 0AA",
"Country": "GB"
},
"CheckEmploymentContactClientCompany": "Make It Happen",
"CheckEmploymentContactClientTel": "012345678",
"CheckEmploymentContactClientFax": "0234346456",
"CheckEmploymentContactClientEmail": "api@verifile.co.uk",
"CheckEmploymentContactClientWeb": "www.verifile.co.uk"
}
},
"CheckEmploymentStatus": "Self_employed_directly",
"CheckEmploymentSelfEmployedStatus": "own_company",
"CheckEmploymentSelfEmployedCompanyRegistrationNo": "12345",
"CheckEmploymentSelfEmployedCompanyCountry": "GB",
"CheckEmploymentRecentPosition": "Designer",
"CheckEmploymentContactEmployer": "immediate",
"CheckEmploymentLocation": "GB",
"CheckEmploymentPayrollNumber": "111114",
"CheckEmploymentSalary": "994500",
"CheckEmploymentStartDate": "2017-01-04",
"CheckType": "EmploymentHistoryWorldwide"
}
]
Response
"Checks": [
{
"ContactDetails": {
"CheckEmploymentContactName": {
"FullName": ""
},
"CheckEmploymentContactAddress": {
"AddressString": ""
},
"CheckEmploymentContactTelephoneNumber": "",
"CheckEmploymentContactFaxNumber": "",
"CheckEmploymentContactEmail": "",
"CheckEmploymentContactWebsite": "",
"CheckEmploymentContactCompanyName": ""
},
"EmployedDirectlyForClient": {
"Accountant": {
"CheckEmploymentContactAccountantName": {
"FullName": "Mr John Alan Smith"
},
"CheckEmploymentContactAccountantAddress": {
"AddressString": "11 Zala iela Bauska Bauskas novads 3901 LV"
},
"CheckEmploymentContactAccountantFirm": "Prime Accounts",
"CheckEmploymentContactAccountantTel": "0123234234",
"CheckEmploymentContactAccountantFax": "023434565464",
"CheckEmploymentContactAccountantEmail": "api@Verifile.co.uk",
"CheckEmploymentContactAccountantWeb": "www.verifile.co.uk"
},
"Management": {
"CheckEmploymentContactManagementName": {
"FullName": "Mrs Joanne Steinberg"
},
"CheckEmploymentContactManagementAddress": {
"AddressString": "20906 Harvest Hill Ln Houston Harris Texas 77073-3127 US"
},
"CheckEmploymentContactManagementCompany": "Managers 'R' US",
"CheckEmploymentContactManagementTel": "0123453453453",
"CheckEmploymentContactManagementFax": "02334634634",
"CheckEmploymentContactManagementEmail": "api@verifile.co.uk",
"CheckEmploymentContactManagementWeb": "verifile.co.uk"
},
"Client": {
"CheckEmploymentContactClientName": {
"FullName": "Ms Emma Happen"
},
"CheckEmploymentContactClientAddress": {
"AddressString": "222 Station Road Bedford Bedfordshire England MK1 0AA GB"
},
"CheckEmploymentContactClientCompany": "Make It Happen",
"CheckEmploymentContactClientTel": "012345678",
"CheckEmploymentContactClientFax": "0234346456",
"CheckEmploymentContactClientEmail": "api@verifile.co.uk",
"CheckEmploymentContactClientWeb": "www.verifile.co.uk"
}
},
"CheckEmploymentStatus": "Self_employed_directly",
"CheckEmploymentSelfEmployedStatus": "own_company",
"CheckEmploymentSelfEmployedCompanyRegistrationNo": "12345",
"CheckEmploymentSelfEmployedCompanyCountry": "GB",
"CheckEmploymentEmployer": "",
"CheckEmploymentRecentPosition": "Designer",
"CheckEmploymentContactEmployer": "immediate",
"CheckEmploymentContactEmployerContactDate": null,
"CheckEmploymentDoNotContactReason": "",
"CheckEmploymentLocation": "GB",
"CheckEmploymentPayrollNumber": "111114",
"CheckEmploymentCandidateReasonForLeaving": "",
"CheckEmploymentCandidateReasonForLeavingOther": "",
"CheckEmploymentSalary": "994500",
"CheckEmploymentNotes": "",
"CheckEmploymentStartDate": "2017-01-04",
"CheckEmploymentFinishDate": "",
"CheckType": "EmploymentHistoryWorldwide",
"CheckState": { "StateDescription": "Application" },
"Id": "10001",
"Comment": ""
}
]