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

# Sanctions Screening Status

> Check the status of automatic sanctions screening.

Thiqwave automatically screens all entities and transactions against international sanctions lists. Use this endpoint to check the screening status of a specific entity or transaction.

## Request

### Headers

<ParamField header="X-API-Key" type="string" required>
  Your Thiqwave API key.
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Must be `application/json`.
</ParamField>

### Path parameters

<ParamField path="id" type="string" required>
  The screening result ID to retrieve.
</ParamField>

## Example

```bash cURL theme={null}
curl https://api.thiqwave.com/v1/compliance/sanctions/scr_01HXYZ1234567890 \
  -H "X-API-Key: your-api-key"
```

## Response

<ResponseField name="id" type="string">
  Unique screening result ID.
</ResponseField>

<ResponseField name="status" type="string">
  Screening outcome: `"clear"` | `"hit"` | `"pending"`.

  * `"clear"` — no matches found on any watchlist.
  * `"hit"` — one or more potential matches found. Review the `matches` array before proceeding.
  * `"pending"` — the screen is still processing (rare; use `GET /v1/compliance/:id` to poll).
</ResponseField>

<ResponseField name="matches" type="object[]">
  Array of potential match objects. Empty when `status` is `"clear"`.

  <Expandable title="Match fields">
    <ResponseField name="matchId" type="string">
      Unique identifier for this match record.
    </ResponseField>

    <ResponseField name="listName" type="string">
      Name of the sanctions or watchlist on which the match was found (e.g., `"OFAC SDN"`, `"UN Consolidated"`).
    </ResponseField>

    <ResponseField name="matchedName" type="string">
      The name string that triggered the match.
    </ResponseField>

    <ResponseField name="score" type="number">
      Confidence score between `0` and `1`. Higher values indicate a closer name match.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="screenedAt" type="string">
  ISO 8601 timestamp of when the screen was run.
</ResponseField>

<Warning>
  Do not proceed with a transaction or business relationship when the status is `"hit"`. Review each entry in `matches` and consult your compliance officer before taking any action. Proceeding without review may violate applicable AML/CFT regulations in the UAE.
</Warning>