Settings (2.0)

Overview

Servers

https://api.kycaid.com/

Addresses

Operations

Create an address

Request

Create and add an address object to an applicant or an affiliated person. Only one address per type may be added to an object

Security

Your API key

Bodyapplication/json

One of:

applicant_idstring(uuid)= 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

typestringrequired

A type of an address object. The possible types are:

REGISTERED for the residential address of a person
ADDITIONAL for any other address associated with a person

Enum"REGISTERED""ADDITIONAL"

full_addressstring or null[ 1 .. 255 ] characters

A full address of an object, including a street address, a unit, a city, a postal code, a country

countrystring or null= 2 characters

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

statestring or null[ 1 .. 50 ] characters

A state of an object

regionstring or null[ 1 .. 50 ] characters

A region of a country of an object

provincestring or null[ 1 .. 50 ] characters

A province (a sub-region of a country) of an object

citystring or null[ 1 .. 50 ] characters

A city or a town of an object

districtstring or null[ 1 .. 50 ] characters

A district (an area of a city) of an object

addressstring or null[ 1 .. 50 ] characters

An address (a street name, a building number, and a unit number) of an object

postal_codestring or null[ 1 .. 20 ] characters

A postal code (zip code, postcode) of an object

street_namestring or null[ 1 .. 50 ] characters

A street name of an object

building_numberstring or null[ 1 .. 20 ] characters

A number of a building of an object

unit_numberstring or null[ 1 .. 20 ] characters

A number of a unit (flat, apartment) of an object

application/json

{
  "applicant_id": "723f46ab04feb64f442946f2953a67eaecf7",
  "type": "REGISTERED",
  "full_address": "45 High Street, Flat 2A, London, SW1A 1AA, United Kingdom",
  "country": "GB",
  "state": "California",
  "region": "Scotland",
  "province": "Ontario",
  "city": "London",
  "district": "Westminster",
  "address": "45 High Street, Flat 2A",
  "postal_code": "SW1A 1AA",
  "street_name": "High Street",
  "building_number": "45",
  "unit_number": "Flat 2A"
}

Responses

OK

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

Bodyapplication/json

address_idstring(uuid)= 36 characters

A unique identifier of an address object, that is assigned by our system after an address entity was created

Response

application/json

{
  "address_id": "723f46ab04feb64f442946f2953a67eaecf7"
}

Update an address

Request

Update records of an address object in our system

In case when an address becomes a part of a created verification, then our system will create a copy of an address object and will provide you with a different address_id in a response

Security

Your API key

Path

address_idstring(uuid)= 36 charactersrequired

A unique identifier of an address object, that is assigned by our system after an address entity was created

Example: 723f46ab04feb64f442946f2953a67eaecf7

Bodyapplication/json

typestring

A type of an address object. The possible types are:

REGISTERED for the residential address of a person or an affiliated person, or the registered address of a company
BUSINESS for the primary business location of a company
ADDITIONAL for any other address associated with a person, an affiliated person, or a company

Enum"REGISTERED""BUSINESS""ADDITIONAL"

full_addressstring or null[ 1 .. 255 ] characters

A full address of an object, including a street address, a unit, a city, a postal code, a country

countrystring or null= 2 characters

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

statestring or null[ 1 .. 50 ] characters

A state of an object

regionstring or null[ 1 .. 50 ] characters

A region of a country of an object

provincestring or null[ 1 .. 50 ] characters

A province (a sub-region of a country) of an object

citystring or null[ 1 .. 50 ] characters

A city or a town of an object

districtstring or null[ 1 .. 50 ] characters

A district (an area of a city) of an object

addressstring or null[ 1 .. 50 ] characters

An address (a street name, a building number, and a unit number) of an object

postal_codestring or null[ 1 .. 20 ] characters

A postal code (zip code, postcode) of an object

street_namestring or null[ 1 .. 50 ] characters

A street name of an object

building_numberstring or null[ 1 .. 20 ] characters

A number of a building of an object

unit_numberstring or null[ 1 .. 20 ] characters

A number of a unit (flat, apartment) of an object

application/json

{
  "type": "REGISTERED",
  "full_address": "45 High Street, Flat 2A, London, SW1A 1AA, United Kingdom",
  "country": "GB",
  "state": "California",
  "region": "Scotland",
  "province": "Ontario",
  "city": "London",
  "district": "Westminster",
  "address": "45 High Street, Flat 2A",
  "postal_code": "SW1A 1AA",
  "street_name": "High Street",
  "building_number": "45",
  "unit_number": "Flat 2A"
}

Responses

OK

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

Bodyapplication/json

address_idstring(uuid)= 36 characters

In case when an address becomes a part of a created verification, then our system will create a copy of an address object and provide you with a different address_id in a response

Response

application/json

{
  "address_id": "723f46ab04feb64f442946f2953a67eaecf7"
}

Delete an address

Request

Deletes an address object from our system

Please note, that addresses may be deleted only before a verification was created

Security

Your API key

Path

address_idstring(uuid)= 36 charactersrequired

A unique identifier of an address object, that is assigned by our system after an address entity was created

Example: 723f46ab04feb64f442946f2953a67eaecf7

No request payload

Responses

OK

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

Bodyapplication/json

address_idstring(uuid)= 36 characters

A unique identifier of an address object, that is assigned by our system after an address entity was created

Response

application/json

{
  "address_id": "723f46ab04feb64f442946f2953a67eaecf7"
}

Affiliated persons

Operations

Applicants

Operations

Blacklist databases

Operations

Business activities

Operations

Countries

Operations

Crypto

Operations

Documents

Operations

Files

Operations

Forms

Operations

Languages

Operations

Non-doc verification services

Operations

Phone numbers

Operations

QES

Operations

Verifications

Operations

Settings (2.0)

Addresses

Create an address

Request

Responses

OK

Was this helpful?

Update an address

Request

Responses

OK

Was this helpful?

Delete an address

Request

Responses

OK

Was this helpful?

Affiliated persons

Applicants

Blacklist databases

Business activities

Countries

Crypto

Documents

Files

Forms

Languages

Non-doc verification services

Phone numbers

QES

Verifications