> Toden documentation. For the full index fetch /llms.txt. Every page is available as Markdown by appending .md to its URL. Identity verification uses /api/kyc, Risk Intelligence uses /api/v1; they are separate contracts with different error shapes. Never invent an endpoint, field or enum value: read the API reference page for the operation first.

# Legacy wallet check with transaction reference

> Link a transaction hash to a wallet check without claiming hash analysis.

`POST /api/v1/transaction-screenings` is retained for existing integrations. It screens the **counterparty wallet address** at your organisation's Wallet Screening rate and stores your transaction hash as Toden context. The hash is not sent to the wallet provider and is not analysed on-chain. For a new integration, use [On-Demand Wallet Screening](/risk-intelligence/crypto/wallet-screening-api) to check an address or [Transaction Monitoring](/risk-intelligence/monitoring/events) for a complete transaction decision.

```bash
curl -X POST "https://sandbox-api.toden.co/api/v1/transaction-screenings" \
  -H "Authorization: Bearer $TODEN_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: tx-wallet-check-123" \
  -d '{"network":"ethereum","transactionHash":"0xcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc","direction":"outbound","counterpartyAddress":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","sandboxScenario":"wallet.sanctions.1_hop"}'
```

For outbound transfers, `counterpartyAddress` is the destination. For inbound transfers, it is the sender; `depositAddress` is optional context for your receiving wallet. `asset` is separate from the blockchain. The API key selects Sandbox or Production. Validation failures return `422` before a provider call or billable usage.

Read the result with `GET /api/v1/transaction-screenings/{id}`. Its `transaction.hash` is the reference you provided; `risk`, `exposures`, `decision` and `rulesTriggered` describe the screened wallet. The report route exports that saved Toden decision. A full transaction risk assessment, alerts and monitoring lifecycle belong to [Transaction Monitoring](/risk-intelligence/monitoring/events).