Contact for Identity Screening

GET {{baseUrl}}/cas/contactsScreening/events/{{requestId}}/contacts/{{contactId}}

Returns a contact by the given contact ID

Scopes Required

  • screening_provider

Response Body

Returns a list of objects that will contain a combination of the below keys

KeyDatatypeComments
contactObjectSee below
requestFirmStringUnique ID of Firm
requestUserStringEmail Address of User making the request

Contact Object

KeyDatatypeComments
addressObjectSee address below
birthDetailsObjectSee birthDetails below
consentbooleanThis indicates that the CAS 360 user has verified that the contact has given consent to proceed with the verification check.
firstNameStringFirst Name of the person
idStringcontactId
lastNameStringLast Name or Surname of the person
middleNameStringMiddle Name of the person
genderStringGender of the person
passportObjectSee passport Object below
PEPCheckRequiredBooleanIf True, a PEP check required by the provider.
typeStringshould be equal to People
referenceStringReference value entered by the user to help identify the event. Max 255 characters.

Address Object

KeyDatatypeComments
blockStringOnly used if country = Singapore or Hong Kong
buildingEstateStringOnly used if country = Singapore or Hong Kong
careOfString
countryStringYes
levelFloorStringOnly used if country = Singapore or Hong Kong
postcodeString
suburbString
stateStringOnly used if country = Australia
streetLine1String
streetLine2String
suburbString
townCityString
unitFlatStringOnly used if country = Singapore or Hong Kong

birthDetails Object

KeyDatatypeComments
birthCountryStringISO 3166 country code/name https://en.wikipedia.org/wiki/ISO_3166 e.g AU
birthDateDateformat = yyyy-MM-dd
birthPlaceString
birthStateString
nationalityStringISO 3166 country code/name https://en.wikipedia.org/wiki/ISO_3166 e.g AU

communicationDetails Object

KeyDatatypeComments
emailstringContact's email address
mobilestringContact's mobile number

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

"{\n    \"contact\": {\n        \"address\": {\n            \"block\": null,\n            \"buildingEstate\": null,\n            \"careOf\": \"\",\n            \"country\": null,\n            \"levelFloor\": null,\n            \"postcode\": \"3187\",\n            \"state\": \"VIC\",\n            \"streetLine1\": \"606 Hawthorn Road\",\n            \"streetLine2\": \"\",\n            \"suburb\": \"BRIGHTON EAST\",\n            \"townCity\": \"BRIGHTON EAST\",\n            \"unitFlat\": null\n        },\n        \"birthDetails\": {\n            \"birthCountry\": \"null\",\n            \"birthDate\": \"null\",\n            \"birthPlace\": \"null\",\n            \"birthState\": \"null\"\n            \"nationality\": \"Australian\"\n        },\n        \"communicationDetails\" {\n            \"email\": \"sdesilva@bglcorp.com.au\",\n            \"mobile\": \"6123123123\"\n        },\n        \"firstName\": \"John\",\n        \"id\": 1178270,\n        \"lastName\": \"Doe\",\n        \"middleName\": null,\n        \"gender\": M,\n        \"pepCheckRequired\": true,\n        \"type\": \"People\"\n        \"reference\": null\n    },\n    \"requestFirm\": \"apitesting\",\n    \"requestUser\": null\n}"