> ## Documentation Index
> Fetch the complete documentation index at: https://developer.verilock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Screen Transaction

> Screen a single transaction for fraud, sanctions, and compliance risks in real time.

## Parameters

<ParamField body="type" type="string" required>
  Transaction type (see [Transaction Types](/transaction-monitoring/list-types))
</ParamField>

<ParamField body="amount" type="number" required>
  Transaction amount
</ParamField>

<ParamField body="currency" type="string" required>
  ISO 4217 currency code (e.g. `USD`, `EUR`)
</ParamField>

<ParamField body="sender" type="object" required>
  Sender details

  <Expandable title="Sender Object">
    <ParamField body="sender.name" type="string" required>
      Sender's full name
    </ParamField>

    <ParamField body="sender.account" type="string" required>
      Sender's account identifier
    </ParamField>

    <ParamField body="sender.country" type="string" required>
      Sender's country (ISO 3166-1 alpha-2)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="receiver" type="object" required>
  Receiver details

  <Expandable title="Receiver Object">
    <ParamField body="receiver.name" type="string" required>
      Receiver's full name
    </ParamField>

    <ParamField body="receiver.account" type="string" required>
      Receiver's account identifier
    </ParamField>

    <ParamField body="receiver.country" type="string" required>
      Receiver's country (ISO 3166-1 alpha-2)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="reference_id" type="string">
  Your internal reference ID
</ParamField>

<ParamField body="metadata" type="object">
  Additional key-value data for context
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    "https://verilock.io/api/v1/transactions/screen" \
    -H "Authorization: Bearer qi_live_your_api_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "type": "wire_transfer",
      "amount": 15000.00,
      "currency": "USD",
      "sender": {
        "name": "Alice Martin",
        "account": "US6712345678",
        "country": "US"
      },
      "receiver": {
        "name": "Bob Fischer",
        "account": "DE8900112233",
        "country": "DE"
      },
      "reference_id": "txn_2026031501"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://verilock.io/api/v1/transactions/screen",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer qi_live_your_api_key_here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        type: "wire_transfer",
        amount: 15000.00,
        currency: "USD",
        sender: {
          name: "Alice Martin",
          account: "US6712345678",
          country: "US",
        },
        receiver: {
          name: "Bob Fischer",
          account: "DE8900112233",
          country: "DE",
        },
        reference_id: "txn_2026031501",
      }),
    }
  );

  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "txn_c4e5f6a7-8b9c-4d0e-a1f2-b3c4d5e6f7a8",
    "risk_score": 42,
    "risk_level": "medium",
    "flags": [
      "cross_border_transfer",
      "amount_above_threshold"
    ],
    "recommendation": "review",
    "screened_at": "2026-03-15T14:22:00Z"
  }
  ```
</ResponseExample>