Skip to main content
POST
/
v1
/
compliance
/
sanctions
Sanctions Screening
curl --request POST \
  --url https://api.example.com/v1/compliance/sanctions \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "type": "<string>",
  "name": "<string>",
  "country": "<string>",
  "nationalId": "<string>",
  "registrationNumber": "<string>"
}
'
{
  "id": "<string>",
  "status": "<string>",
  "matches": [
    {
      "matchId": "<string>",
      "listName": "<string>",
      "matchedName": "<string>",
      "score": 123
    }
  ],
  "screenedAt": "<string>"
}
Run a real-time sanctions and watchlist screen on an individual or business before transacting. Thiqwave screens the subject against international sanctions lists, regional watchlists, and official business registries. Results are returned synchronously.

​
Request

​
Headers

​
X-API-Key
string
required
Your Thiqwave API key.
​
Content-Type
string
required
Must be application/json.

​
Body

​
type
string
required
Subject type. Either "individual" or "business".
​
name
string
required
Full legal name of the individual or registered business name.
​
country
string
required
ISO 3166-1 alpha-2 country code of the subject’s nationality or registration jurisdiction.
​
nationalId
string
National ID or passport number. Recommended for "individual" screenings to reduce false positives.
​
registrationNumber
string
Commercial registration number. Recommended for "business" screenings.

​
Example

cURL
curl --request POST \
  --url https://api.thiqwave.com/v1/compliance/sanctions \
  --header "X-API-Key: your-api-key" \
  --header "Content-Type: application/json" \
  --data '{
    "type": "individual",
    "name": "Ahmad Al-Mansouri",
    "country": "AE",
    "nationalId": "784-1985-1234567-1"
  }'

​
Response

​
id
string
Unique screening result ID.
​
status
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).
​
matches
object[]
Array of potential match objects. Empty when status is "clear".
​
screenedAt
string
ISO 8601 timestamp of when the screen was run.
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 Saudi Arabia and the UAE.