Skip to main content
POST
Search

Authorizations

ds-api-token
string
header
required

Body

application/json

AML Search

AML Search request

full_name
string
required

The full_name is a mandatory field and serves as the primary search term, unless both the first and last names are provided. In such a scenario, the combination of the first and last names becomes the primary term, and the full_name is employed to enhance the relevance of results.

Example:

"Grace MUGABE"

first_name
string

This optional field serves to optimize the overall search experience when both first_name and last_name are provided.

Example:

"Grace"

last_name
string

This optional field serves to optimize the overall search experience when both first_name and last_name are provided.

Example:

"MUGABE"

countries
string[]

ISO 3166-1 alpha-2 country codes

Example:
cities
string[]
postal_codes
string[]
date_of_birth
object

Date range, represented as a pair of dates in ISO 8601 format

risk_scores
enum<string>[]

Assigned Risk Score

Available options:
Low,
Medium,
High
Example:
tags
enum<string>[]

Possible Entity Tags

Available options:
Finance,
Legal,
Terrorism,
Criminal,
PEP,
Media,
Social,
Sanctions,
UnofficialSource,
Leaks,
CompanyRegistry,
Associate,
Debarred,
PublicInterest,
RegulatoryWarning
Example:
entity_types
enum<string>[]

Possible types

Available options:
Person,
Organization,
Country,
Vessel,
Aircraft,
CryptoWallet
Example:
sources
string[]

Possible Source IDs, contains all publicly available sources, constantly updated, for the most up to date list please check https://dash.dataspike.io/pep-sanctions/data-sources

fuzziness
boolean
default:true

A boolean flag (True/False). When set to True (default), broad matches are allowed. If set to False, only exact matches are permitted.

fuzziness_level
number<double> | null
default:1

Controls the strictness of name matching. 0 means exact match, 1 means broad match. Recommended value is 1. Intermediate values (e.g., 0.5) can be used to fine-tune the balance between precision and scope.

Required range: 0 <= x <= 1
phonetics
boolean
default:true

This setting enables phonetic similarity during AML searches, which is helpful for finding similar names across different languages. We generally recommend keeping this set to True.

registration_ids
string[]
mode
enum<string>
default:AUTO

Controls how name fields are used for matching.

  • AUTO — automatically determine the best matching strategy.
  • FULL_NAME_ONLY — use only the full_name field.
  • FIRST_AND_LAST_NAME_ONLY — use only the first_name and last_name fields.
Available options:
AUTO,
FULL_NAME_ONLY,
FIRST_AND_LAST_NAME_ONLY
gender
string

Filter results by gender (e.g. Male, Female, Other)

search_kyb
boolean

When set to true, also search KYB (company) databases in addition to individual records.

Response

200 - application/json

AML Search Result

requested_name
string
search_uuid
string

Search id, could be use later to fetch the existing search result

max_risk_score
enum<string>

Assigned Risk Score

Available options:
Low,
Medium,
High
data
object[]
fatf_records
object[]

FATF (Financial Action Task Force) records for countries referenced in search results