Skip to main content
GET
/
compliance
/
kya
/
screenings
/
{screening_id}
import cobo_waas2
from cobo_waas2.models.kya_screening_result import KyaScreeningResult
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.ComplianceApi(api_client)
    screening_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"

    try:
        # Get KYA address screening result
        api_response = api_instance.get_kya_screening(screening_id)
        print("The response of ComplianceApi->get_kya_screening:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ComplianceApi->get_kya_screening: %s\n" % e)


{
  "screening_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain_id": "ETH",
  "note": "High-value deposit address",
  "created_timestamp": 1721530814236,
  "requested_by": "user_abc123def456",
  "status": "Screened",
  "risk_assessment": {
    "level": "Low",
    "summary": "No significant risks detected",
    "details": [
      {
        "category": "sanctions",
        "exposure": "none"
      },
      {
        "category": "fraud",
        "exposure": "low"
      }
    ]
  }
}
import cobo_waas2
from cobo_waas2.models.kya_screening_result import KyaScreeningResult
from cobo_waas2.rest import ApiException
from pprint import pprint

# See configuration.py for a list of all supported configurations.
configuration = cobo_waas2.Configuration(
    # Replace `<YOUR_PRIVATE_KEY>` with your private key
    api_private_key="<YOUR_PRIVATE_KEY>",
    # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
    host="https://api.dev.cobo.com/v2",
)
# Enter a context with an instance of the API client
with cobo_waas2.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = cobo_waas2.ComplianceApi(api_client)
    screening_id = "f47ac10b-58cc-4372-a567-0e02b2c3d479"

    try:
        # Get KYA address screening result
        api_response = api_instance.get_kya_screening(screening_id)
        print("The response of ComplianceApi->get_kya_screening:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling ComplianceApi->get_kya_screening: %s\n" % e)

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.

Path Parameters

​
screening_id
string<uuid>
required

The unique identifier (UUID) of the address screening request.

Response

Successfully retrieved address screening result.

Complete address screening result including risk assessment.

​
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

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