---
title: "Submit screening result for a blockchain address"
method: GET
path: "/v4/kya/screening_v2"
tags: ["v4/kya"]
---

# Submit screening result for a blockchain address

`GET /v4/kya/screening_v2`

## Request

- Base URL: `https://api.skyinsights.certik.com`
- URL: `https://api.skyinsights.certik.com/v4/kya/screening_v2`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-API-Secret`
- TypeScript: <https://skmtc.dev/certik/apis/compliance-aml-saas-api/docs/v4/kya/screening_v2/get.ts> (a function with typed inputs; its response is checked against the schema)

Supports both sync and async modes. In async mode (default), immediately returns a task ID. In sync mode, waits up to 15 seconds for the result; if not completed within this time, returns the task ID.

## Query parameters

- `chain` string, required
- `address` string, required
- `rule_set_id` string
- `mode` string

## Response `200`

OK

- object
  - `code` integer
  - `data` object, nullable
    - `address` string
    - `api_key` string
    - `chain` string
    - `created_at` string
    - `error` string
    - `finished_at` string
    - `org_id` string
    - `result` ScreeningTaskScreeningResult
      - `counterparties` object
      - `entities` EntityEntity[]
        - `country` EntityLocalized
          - `en` string
          - `zh` string
        - `description` EntityLocalized
          - `en` string
          - `zh` string
        - `entity_id` string
        - `entity_name` EntityLocalized
          - `en` string
          - `zh` string
        - `link` string
        - `other_link` string
      - `labels` LabelLabels[]
        - `address` string
        - `category` string
        - `chain` string
        - `label` string
        - `source` string
        - `sub_category` string
        - `ts` integer
      - `risk_results` object
    - `retry_count` integer
    - `rule_set_id` string
    - `started_at` string
    - `status` string
    - `updated_at` string
  - `message` string

## Other responses

- `202`: Accepted
- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/certik/apis/compliance-aml-saas-api.md) - [All operations](https://skmtc.dev/certik/apis/compliance-aml-saas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/certik/apis/compliance-aml-saas-api/revisions/965d8457aab3?raw)