Skip to main content
POST
Try Cobo WaaS Skill in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀

Authorizations

BIZ-API-KEY
string
header
required

The API key. For more details, refer to API key.

In the API playground, enter your API secret, and your API key will be accordingly calculated.

Body

application/json

The request body to create KYA address screening requests.

Information about address screening requests.

screenings
object[]
required

List of address screening requests. Maximum 50 addresses per call.

Required array length: 1 - 50 elements

Response

Successfully created address screening requests.

request_id
string
required

The idempotency identifier from the request, unique within your organization, used for tracking and troubleshooting. Only present in create response.

Example:

"scan_eth_addr1_20240721"

screening_id
string<uuid>
required

The unique system-generated identifier for this screening request (UUID format, fixed 36 characters).

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

address
string
required

The screened blockchain address.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

chain_id
string
required

The chain identifier.

Example:

"ETH"

created_timestamp
integer<int64>
required

The time when the screening request was created, in Unix timestamp format, measured in milliseconds.

Example:

1721530814236

requested_by
string
required

The identifier of the user or application that created this screening request.

Example:

"user_abc123def456"

status
enum<string>
required

The status of the address screening request.

Available options:
Submitted,
Pending,
Screened,
Failed
Example:

"Screened"

note
string

Optional note for this address screening.

Example:

"High-value transaction screening"

risk_assessment
object | null

Risk assessment information. Only present when status is 'Screened'. Null for other statuses.