---
title: "List transaction screenings"
method: GET
path: "/v4/kyt/screening/list"
tags: ["v4/kyt"]
---

# List transaction screenings

`GET /v4/kyt/screening/list`

## Request

- Base URL: `https://api.skyinsights.certik.com`
- URL: `https://api.skyinsights.certik.com/v4/kyt/screening/list`
- 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/list/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.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `code` integer
  - `data` object, nullable
    - `limit` integer
    - `list` TxscreeningResult[]
      - `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
              - …
            - `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
    - `offset` integer
  - `message` string

## Other responses

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