Skip to content

Get applicant

Request

Get data on a created applicant

Security
API-Key
Path
applicant_idstring, = 36 charactersrequired

A unique identifier of an applicant, that is assigned by our system after an applicant object was created with a “Create an applicant” request

Example:27c5caea93ee4656881ef9a30fadd21a3768
curl -i -X GET \
  https://api.kycaid.com/applicants/27c5caea93ee4656881ef9a30fadd21a3768 \
  -H 'API-Key: YOUR_API_KEY_HERE'

Responses

OK

The request was successful, and our system returned an expected response.

Bodyapplication/json
One of:
applicant_idstring, = 36 characters

A unique identifier of an applicant, that is assigned by our system after an applicant object was created with a “Create an applicant” request

Example:"27c5caea93ee4656881ef9a30fadd21a3768"
external_applicant_idstring or null, [ 0 .. 50 ] characters

A unique identifier of your user in your system

Example:"8ba166fd-e9ba-49c6-b91a-fdbf0f63f939"
typestring

A type of an applicant object. PERSON type is used for KYC process, and COMPANY type is used for KYB process

Value:"PERSON"
Example:"PERSON"
created_atstring

A date and time of creation of an object, set by our system

Example:"2024-07-01 15:27:15"
profile_statusstring or null

A status of an object profile verification, set by our system or our manager

Enum:"valid""invalid"
Example:"valid"
profile_commentstring or null

A custom comment left by our manager for an object

Example:"Suspicious activity"
first_namestring or null, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$

The first name of a person

Example:"Josh"
origin_first_namestring or null, (name), [ 1 .. 64 ] characters

A first name of an object, set in a native language

Example:"Джош"
middle_namestring or null, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$

The middle name of a person

Example:"David"
origin_middle_namestring or null, (name), [ 1 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$

A middle name of an object, set in a native language

Example:"Conrad"
last_namestring or null, (name), [ 2 .. 64 ] characters^[a-zA-Z ,.''-]{2,64}$

The last name of a person

Example:"Coffey"
origin_last_namestring or null, (name), [ 1 .. 64 ] characters

A last name of an entity, set in a native language

Example:"Кофі"
residence_countrystring or null, = 2 characters

A residence country of an object. A two-letter country code according to ISO 3166-2

Example:"GB"
nationalitystring or null, = 2 characters

A nationality country of a person. A two-letter country code according to ISO 3166-2

Example:"GB"
dobstring or null, (date)

The date of birth of a person, formatted as “YYYY-MM-DD” according to ISO 8601

Example:"1976-02-21"
genderstring or null

The gender of a person. M indicates male; F indicates female

Enum:"M""F"
Example:"M"
emailstring or null, (email), [ 1 .. 254 ] characters

The email address of a person or a company

Example:"josh.coffey@example.com"
phonestring or null, [ 1 .. 15 ] characters

The phone number of a person or a company

Example:"441172345678"
phone_statusstring or null

A status of an object phone verification, set by our system or our manager

Enum:"valid""invalid"
Example:"valid"
wallet_addressstring or null, [ 1 .. 50 ] characters

A cryptocurrency wallet address of an object

Example:"GQzMeEMwAR44ugoNCifTb5NdRKos0GduDUPeNh6AgV46"
telegram_usernamestring or null, [ 1 .. 32 ] characters

A username of an object in Telegram instant messaging service

Example:"JoshCoffey"
pepboolean or null

The status of a person as a politically exposed person (PEP)

Enum:truefalse
Example:false
custom_field_1string or null, [ 1 .. 2048 ] characters

A custom parameter to store additional data for an object by your managers

Example:"This applicant was marked as suspicious by Mark L. at 11:40"
custom_field_2string or null, [ 1 .. 2048 ] characters

A custom parameter to store additional data for an object by your managers

Example:"This applicant was marked as suspicious by Mark L. at 11:40"
custom_field_3string or null, [ 1 .. 2048 ] characters

A custom parameter to store additional data for an object by your managers

Example:"This applicant was marked as suspicious by Mark L. at 11:40"
custom_field_4string or null, [ 1 .. 2048 ] characters

A custom parameter to store additional data for an object by your managers

Example:"This applicant was marked as suspicious by Mark L. at 11:40"
custom_field_5string or null, [ 1 .. 2048 ] characters

A custom parameter to store additional data for an object by your managers

Example:"This applicant was marked as suspicious by Mark L. at 11:40"
decline_reasonsany
addressesany
documentsany
questionnairesany
verification_statusany
verifications_countany
Response
{
  "applicant_id": "27c5caea93ee4656881ef9a30fadd21a3768",
  "external_applicant_id": "8ba166fd-e9ba-49c6-b91a-fdbf0f63f939",
  "type": "PERSON",
  "created_at": "2024-07-01 15:27:15",
  "profile_status": "valid",
  "profile_comment": "Suspicious activity",
  "first_name": "Josh",
  "origin_first_name": "Джош",
  "middle_name": "David",
  "origin_middle_name": "Conrad",
  "last_name": "Coffey",
  "origin_last_name": "Кофі",
  "residence_country": "GB",
  "nationality": "GB",
  "dob": "1976-02-21",
  "gender": "M",
  "email": "josh.coffey@example.com",
  "phone": "441172345678",
  "phone_status": "valid",
  "wallet_address": "GQzMeEMwAR44ugoNCifTb5NdRKos0GduDUPeNh6AgV46",
  "telegram_username": "JoshCoffey",
  "pep": false,
  "custom_field_1": "This applicant was marked as suspicious by Mark L. at 11:40",
  "custom_field_2": "This applicant was marked as suspicious by Mark L. at 11:40",
  "custom_field_3": "This applicant was marked as suspicious by Mark L. at 11:40",
  "custom_field_4": "This applicant was marked as suspicious by Mark L. at 11:40",
  "custom_field_5": "This applicant was marked as suspicious by Mark L. at 11:40",
  "decline_reasons": null,
  "addresses": null,
  "documents": null,
  "questionnaires": null,
  "verification_status": null,
  "verifications_count": null
}