---
title: "Get transaction screening result"
method: GET
path: "/v4/kyt/screening/result"
tags: ["v4/kyt"]
---

# Get transaction screening result

`GET /v4/kyt/screening/result`

## Request

- Base URL: `https://api.skyinsights.certik.com`
- URL: `https://api.skyinsights.certik.com/v4/kyt/screening/result`
- 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/kyt/screening/result/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns rule_name and rule_set_name resolved from the rule-set catalog for display. Address risk factor triggers also include rule_name when resolvable.

## Query parameters

- `task_id` string, required

## Response `200`

OK

- object
  - `code` integer
  - `data` object, nullable
    - `address_info` object, nullable
    - `address_order` string[], nullable
    - `address_screenings` object, nullable
    - `completeness` string
    - `created_at` string
    - `error` string
    - `issues` TxscreeningIssue[], nullable
      - `address_key` string
      - `code` string
      - `message` string
    - `overview` TxscreeningOverview
      - `candidate_count` integer
      - `categories` RiskCategory[], nullable
      - `completeness` string
      - `failed_address_count` integer
      - `findings` TxscreeningFinding[], nullable
        - `category` '' | 'Sanctioned' | 'TerroristFinancing' | 'ChildAbuse' | 'Hack' | 'Scam' | 'Ransomware' | 'Darkweb' | 'Mixing' | 'Laundering' | 'NoKYCExchange' | 'Gambling' | 'Blocked' | 'Blacklisted' | 'UnregisteredVASP' | 'RiskyEscrow' | 'HumanTrafficking' | 'PoliticalFigure' | 'Unknown' | 'Guarantee'
        - `evidence` TxscreeningFactorRef[], nullable
          - `factor_id` string
          - `screened_address` string
          - `transfer_ids` string[], nullable
        - `kind` string
        - `raw_score` integer
        - `risk_level` string
        - `source_address` string
      - `key_transfer_count` integer
      - `raw_score` integer
      - `risk_level` string
      - `risk_score` integer
      - `screened_address_count` integer
    - `rule_name` string: Display names are resolved on read so historical tasks reflect catalog renames.
    - `rule_set_id` string
    - `rule_set_name` string
    - `screening_id` string
    - `selection_policy` TxscreeningPolicy
      - `max_key_transfers` integer
      - `max_screened_addresses` integer: MaxScreenedAddresses bounds BTC participant assessments independently of movement count.
      - `version` string
    - `status` string
    - `transaction` TxscreeningTransactionInfo
      - `block_hash` string
      - `block_number` integer
      - `chain` string
      - `from` string: From is the transaction initiator; omitted for UTXO transactions.
      - `hash` string
      - `model` string: Model distinguishes account-based transfers from future UTXO adapters.
      - `status` string
      - `timestamp` string
      - `to` string
    - `transfers` TxscreeningTransfer[], nullable
      - `amount` string
      - `applied` boolean
      - `decimals` integer
      - `from` string
      - `id` string
      - `log_index` integer
      - `participant_addresses` string[], nullable: BTC supplies all screenable input/output addresses. Account chains use From/To.
      - `raw_amount` string
      - `risk` TxscreeningAggregate
        - `categories` RiskCategory[], nullable
        - `completeness` string
        - `findings` TxscreeningFinding[], nullable
          - `category` '' | 'Sanctioned' | 'TerroristFinancing' | 'ChildAbuse' | 'Hack' | 'Scam' | 'Ransomware' | 'Darkweb' | 'Mixing' | 'Laundering' | 'NoKYCExchange' | 'Gambling' | 'Blocked' | 'Blacklisted' | 'UnregisteredVASP' | 'RiskyEscrow' | 'HumanTrafficking' | 'PoliticalFigure' | 'Unknown' | 'Guarantee'
          - `evidence` TxscreeningFactorRef[], nullable
            - `factor_id` string
            - `screened_address` string
            - `transfer_ids` string[], nullable
          - `kind` string
          - `raw_score` integer
          - `risk_level` string
          - `source_address` string
        - `raw_score` integer
        - `risk_level` string
        - `risk_score` integer
      - `selection` TxscreeningSelection
        - `reasons` string[], nullable
        - `status` string
      - `to` string
      - `token_address` string
      - `token_symbol` string
      - `trace_address` integer[], nullable
      - `type` string
      - `usd_value` number
      - `utxo` TxscreeningUTXOMovement
        - `inputs` TxscreeningUTXOInput[]
          - `addresses` string[]
          - `amount` string
          - `coinbase` boolean
          - `index` integer
          - `output_index` integer
          - `raw_amount` string
          - `script_pubkey` string
          - `script_type` string
          - `tx_hash` string
          - `usd_value` number: USDValue uses the screening-time BTC reference price; absent when amount or price is unavailable.
        - `outputs` TxscreeningUTXOOutput[]
          - `addresses` string[]
          - `amount` string
          - `index` integer
          - `raw_amount` string
          - `script_pubkey` string
          - `script_type` string
          - `usd_value` number: USDValue uses the same BTC reference price as all inputs and the enclosing transfer.
    - `updated_at` string
  - `message` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `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)