Skip to content

Overview (1.0)

Download OpenAPI description
risks-check.json
risks-check.yaml
Overview
Terms of Service
Languages
Servers
https://api.kycaid.com

Blacklist databases

Access and query global databases to identify individuals or entities previously flagged for high-risk activities. Use this tool to cross-reference user data against known risk records

Operations

Adverse media check

Search and analyze public sources for negative news or reputational risks associated with an individual. It helps detect potential issues that might not yet be reflected in official government or regulatory databases.

Operations

Crypto

Verify the risk profile of cryptocurrency addresses. Detect links to illicit wallets, mixing services, or high-risk exchanges to ensure the safety of digital asset transfers.

Operations

Phone numbers

Validate phone numbers and assess their technical risk level. Identify virtual numbers (VOIP), disposable SIMs, and ecarrier-specific data to flag potential fraudulent activity.

Operations

Transaction screening

Transaction screening allows for real-time analysis of financial operations based on your custom risk logic. Use this tool to evaluate payment parameters, such as directions and amounts, to automate decision-making and identify potentially suspicious activities.

Operations

Submit transaction for screening

Request

Use this endpoint to submit transaction data for screening. The system analyzes the payment parameters against your selected ruleset_id and delivers the result asynchronously to your callback_url. To identify the customer, you must provide either an internal applicant_id or your external_applicant_id.

Security
API-Key
Bodyapplication/jsonrequired
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

external_applicant_idstring or null[ 0 .. 50 ] characters

A unique identifier of your user in your system

external_applicant_registered_atstring= 19 characters

The date and time of user registration in the customer's system. Must be in UTC and follow the YYYY-MM-DD hh:mm:ss format. Cannot be a future date

transactionobject
ruleset_idstring= 36 characters^[a-fA-F0-9]{36}$

The unique 36-character hexadecimal identifier of the screening ruleset. This ID is automatically generated after you create a ruleset in the Dashboard. It determines which ruleset will be applied to the transaction

application/json
{
  "applicant_id": "723f46ab04feb64f442946f2953a67eaecf7",
  "external_applicant_id": "cb1eebbe-9945-4e64-8f60-c920f1e3e237",
  "external_applicant_registered_at": "2025-12-19 18:44:08",
  "transaction": {
    "direction": "incoming",
    "amount": "16.003892000000000000",
    "asset": "GBP",
    "created_at": "2026-02-01 15:27:15"
  },
  "ruleset_id": "56ddfc5d0c732248952b1f30a337494fc930"
}

Responses

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

Bodyapplication/json
statusstring
Example: "ok"
dataobject
Response
application/json
{
  "status": "ok",
  "data": {
    "service_request_id": "6bff21e17da144418b7643267ba4502930a9"
  }
}

QES

Verify Qualified Electronic Signatures (QES) to confirm the authenticity and legal integrity of digitally signed documents.

Operations