Skip to content

Overview (1.0)

Overview

Terms of Service

Languages
Servers

https://api.kycaid.com/

Addresses

Addresses

Operations

Affiliated persons

Affiliated persons

Operations

Applicants

Applicants

Operations

Create an applicant

Request

Create a new applicant object in the system

Security
your_api_key
Bodyapplication/json
One of:
typestringrequired
Value"PERSON"
first_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
middle_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
last_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
dobstring or null(date)
genderstring or null
Enum"M""F"
pepboolean or null
Enumtruefalse
residence_countrystring or null= 2 characters
nationalitystring or null= 2 characters
phonestring or null[ 1 .. 15 ] characters
emailstring or null(email)[ 1 .. 254 ] characters
telegram_usernamestring or null[ 1 .. 32 ] characters
wallet_addressstring or null[ 1 .. 50 ] characters
external_applicant_idstring or null[ 0 .. 50 ] characters
custom_field_1string or null[ 1 .. 2048 ] characters
custom_field_2string or null[ 1 .. 2048 ] characters
custom_field_3string or null[ 1 .. 2048 ] characters
custom_field_4string or null[ 1 .. 2048 ] characters
custom_field_5string or null[ 1 .. 2048 ] characters
application/json
{
  "type": "PERSON",
  "first_name": "Josh",
  "middle_name": "David",
  "last_name": "Coffey",
  "dob": "1976-02-21",
  "gender": "M",
  "pep": false,
  "residence_country": "GB",
  "nationality": "GB",
  "phone": "441172345678",
  "email": "josh.coffey@example.com",
  "telegram_username": "JoshCoffey",
  "wallet_address": "0xb96FdB81a90Ee8aB5b69B2b5Eb7a401ab8c274D8",
  "external_applicant_id": "cb1eebbe-9945-4e64-8f60-c920f1e3e237",
  "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"
}

Responses

OK

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

Bodyapplication/json
applicant_idstring= 36 characters
Response
application/json
{
  "applicant_id": "723f46ab04feb64f442946f2953a67eaecf7"
}

Get an applicant

Request

Get data on a created applicant

Security
your_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: 723f46ab04feb64f442946f2953a67eaecf7
No request payload

Responses

OK

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

Bodyapplication/json
One of:
applicant_idstring= 36 characters
external_applicant_idstring or null[ 0 .. 50 ] characters
typestring
Value"PERSON"
created_atstring(date-time)
profile_statusstring or null
Enum"valid""invalid"
profile_commentstring or null
first_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
origin_first_namestring or null(name)[ 1 .. 64 ] characters
middle_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
origin_middle_namestring or null(name)[ 1 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
last_namestring or null(name)[ 2 .. 64 ] characters^[a-zA-Z ,.''-]{1,64}$
origin_last_namestring or null(name)[ 1 .. 64 ] characters
residence_countrystring or null= 2 characters
nationalitystring or null= 2 characters
dobstring or null(date)
genderstring or null
Enum"M""F"
emailstring or null(email)[ 1 .. 254 ] characters
phonestring or null[ 1 .. 15 ] characters
phone_statusstring or null
Enum"valid""invalid"
wallet_addressstring or null[ 1 .. 50 ] characters
telegram_usernamestring or null[ 1 .. 32 ] characters
pepboolean or null
Enumtruefalse
custom_field_1string or null[ 1 .. 2048 ] characters
custom_field_2string or null[ 1 .. 2048 ] characters
custom_field_3string or null[ 1 .. 2048 ] characters
custom_field_4string or null[ 1 .. 2048 ] characters
custom_field_5string or null[ 1 .. 2048 ] characters
decline_reasonsany
addressesany
documentsany
questionnairesany
verification_statusany
verifications_countany
Response
application/json
{
  "applicant_id": "723f46ab04feb64f442946f2953a67eaecf7",
  "external_applicant_id": "cb1eebbe-9945-4e64-8f60-c920f1e3e237",
  "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": "0xb96FdB81a90Ee8aB5b69B2b5Eb7a401ab8c274D8",
  "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
}

Update an applicant

Request

Update data of a created applicant

Security
your_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: 723f46ab04feb64f442946f2953a67eaecf7
No request payload

Responses

OK

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

Bodyapplication/json
object
Response
application/json
{}

Documents

Documents

Operations

Files

Files

Operations

Forms

Forms

Operations

Verifications

Verifications

Operations