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 CheckEmploymentContactEmployer is set to No_do_not_contact or Contact_from
CheckEmploymentCandidateReasonForLeaving Reason for leaving The candidates reason for leaving this employment String if CheckEmploymentIsCurrent is set to false employmentreasonforleaving
CheckEmploymentCandidateReasonForLeavingOther Details about Reason for leaving The candidates reason for leaving this employment String 2 512 If CheckEmploymentCandidateReasonForLeaving is set to Other
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 CheckEmploymentSelfEmployedStatus is own_company
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": ""
  }
]