Candidate Section


For the Candidate Entry, this describes the Candidate section of the order submission body.

CurrentName

This section describes the details of the name of the candidate that they are known as at the time the order is created.

The current name section is mandatory for both client and candidate entry orders.

"CurrentName": {
    "Title":"Ms",
    "FirstName": "Amy",
    "LastName": "Smith",
    "MiddleNames": "Clare",
    "IsFromBirth": "false",
    "KnownFromDate": "2011-10-31"
}

PreviousNames

This section describes the details of the previous names of the candidate. This should describe all the names of the candidate back to birth.

The previous name section is mandatory for client entry orders but is not allowed in candidate entry orders.

"PreviousNames": 
[
    {
        "Title":"Miss",
        "FirstName": "Amy",
        "LastName": "Jones",
        "MiddleNames": "Clare",
        "IsFromBirth": "true",
        "KnownToDate": "2011-10-31"
    }
]

AddressList

This section describes the details of the addresses of the candidate.

The address list section is mandatory for client entry orders but is not allowed in candidate entry orders.

"AddressList": [
      {
        "Address": {
          "FlatNumber": "6b",
          "HouseNumber": "666",
          "HouseName": "My House",
          "StreetName": "Gold Furlong",
          "Locality": "Marston Moretaine",
          "Town": "Bedford",
          "County": "Bedfordshire",
          "State": "England",
          "Postcode": "MK43 0EG",
          "Country": "GB"
        },
        "DateMovedToThisAddress": "2014-05-05",
        "IsCurrentAddress": true
      }
    ]

PersonalInfo

This section describes the details of the personal information of the candidate.

The personal info section is mandatory for both client and candidate entry orders.

"PersonalInfo": {
      "MobilePhone": {
        "PhoneNumber": "07777777777",
        "CountryCode": "GB"
      },
      "HomePhone": {
        "PhoneNumber": "07777777777",
        "CountryCode": "GB"
      },
      "Gender": "Male",
      "DateOfBirth": "1975-04-09",
      "PositionAppliedFor": "Baker",
      "ApplicantType": "Candidate",
      "CandidateEmail": "api@verifile.co.uk",
      "NationalityAtBirth": "GB",
      "CountryOfBirth": "GB",
      "TownOfBirth": "Haywards Heath"
}

Identity

This section describes the details of the identity documents of the candidate.

The identity section is mandatory for client entry orders but is not allowed in candidate entry orders.

"Identity": {
      "PassportDocument": {
        "PassportIssuingCountry": "GB",
        "PassportNumber": "123456789",
        "PassportIssueDate": "2014-09-01",
        "PassportExpiryDate": "2024-09-01"
      },
      "NationalInsuranceNumberDocument": {
        "OverseasIdentityNumber": {},
        "NationalInsuranceNumber": "JR456789A"
      }
}