Skip to content

Tax ID numbers

Request

Retrieve information on tax ID numbers from the Kycaid blacklist databases to check for compliance with laws and regulations. Each response may have several objects, with one object per a blacklist

Security
API-Key
Bodyapplication/json
tax_id_numberstring, [ 2 .. 32 ] charactersrequired

A tax identification number

Example:"1129821775"
tax_id_countrystring or null, = 2 characters

An issuing country of a tax identification number. A two-letter country code according to ISO 3166-2

Example:"GB"
bdb_typesArray of strings

A type of blacklist databases to make a check

  • SANCTIONS: Global and local sanctions databases
  • PEP: Databases of politically exposed persons (PEP)
  • WANTED: Databases of persons being searched for by the police
  • EXPIRED: Databases of stolen or lost documents
Items Enum:"INTERNAL""SANCTIONS""PEP""WANTED""EXPIRED"
Example:
[
  "SANCTIONS"
]
{
  "tax_id_number": "1129821775",
  "tax_id_country": "GB",
  "bdb_types": [
    "SANCTIONS"
  ]
}

Responses

OK

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

Bodyapplication/json
One of:
dataArray of objects
Response
{
  "data": [
    {
      "full_name": "Josh Coffey",
      "origin_full_name": "Джош Кофі",
      "first_name": "Josh",
      "origin_first_name": "Джош",
      "last_name": "Coffey",
      "origin_last_name": "Кофі",
      "middle_name": "David",
      "origin_middle_name": "Conrad",
      "residence_country": "GB",
      "dob": "1976-02-21",
      "gender": "M",
      "description": "Reciprocal - 2010-04-30",
      "bdb_name": "Open Sanctions Default",
      "bdb_type": [
        "SANCTIONS"
      ],
      "accuracy": 75
    }
  ]
}