> ## 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.

# List Transactions

> Retrieve a paginated list of screened transactions with optional filters.

## Query Parameters

<ParamField query="page" type="integer">
  Page number (default: `1`)
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page (default: `20`, max: `100`)
</ParamField>

<ParamField query="risk_level" type="string">
  Filter by risk level: `low`, `medium`, `high`, `critical`
</ParamField>

<ParamField query="status" type="string">
  Filter by decision status: `pending`, `approved`, `blocked`, `escalated`
</ParamField>

<ParamField query="from" type="string">
  Start date in `YYYY-MM-DD` format
</ParamField>

<ParamField query="to" type="string">
  End date in `YYYY-MM-DD` format
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET \
    "https://verilock.io/api/v1/transactions?risk_level=high&per_page=10" \
    -H "Authorization: Bearer qi_live_your_api_key_here" \
    -H "Accept: application/json"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "txn_c4e5f6a7-8b9c-4d0e-a1f2-b3c4d5e6f7a8",
        "type": "wire_transfer",
        "amount": 15000.00,
        "currency": "USD",
        "risk_score": 78,
        "risk_level": "high",
        "recommendation": "review",
        "status": "pending",
        "screened_at": "2026-03-15T14:22:00Z"
      },
      {
        "id": "txn_a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
        "type": "crypto_transfer",
        "amount": 48250.00,
        "currency": "USD",
        "risk_score": 91,
        "risk_level": "high",
        "recommendation": "block",
        "status": "blocked",
        "screened_at": "2026-03-14T09:15:00Z"
      }
    ],
    "meta": {
      "current_page": 1,
      "per_page": 10,
      "total": 47,
      "last_page": 5
    }
  }
  ```
</ResponseExample>