POST
/
v1
/
sanctions
/
cases
/
:caseId
/
decisions
curl -X POST https://v2.app-dev.zquence.com/v1/sanctions/cases/68bbd741f4c6f683f94ca211/decisions \
  -H "content-type: application/json" \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY" \
  -d '{
    "disposition": "FALSE_POSITIVE",
    "expectedVersion": 1,
    "reason": "Date of birth and nationality do not match the listed subject."
  }'

{
  "_id": "68bbd741f4c6f683f94ca211",
  "projection": {
    "state": "FALSE_POSITIVE",
    "version": 2,
    "latestAttemptId": "68bbd741f4c6f683f94ca212",
    "accountRestricted": false
  },
  "decisions": [
    {
      "disposition": "FALSE_POSITIVE",
      "reason": "Date of birth and nationality do not match the listed subject.",
      "createdAt": "2026-08-12T10:22:14.000Z"
    }
  ]
}
Requires API-key scope sanctions.review and tenant permission sanctions.review.decide.
​
caseId
string
required

​
Body

​
disposition
string
required
A supported decision disposition.
​
expectedVersion
number
required
Current projection.version from the case.
​
reason
string
Required when clearing or retaining a zero-candidate hold and for accepted risk.
​
futureReviewAt
string
Future ISO 8601 timestamp required for ACCEPTED_RISK.
curl -X POST https://v2.app-dev.zquence.com/v1/sanctions/cases/68bbd741f4c6f683f94ca211/decisions \
  -H "content-type: application/json" \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY" \
  -d '{
    "disposition": "FALSE_POSITIVE",
    "expectedVersion": 1,
    "reason": "Date of birth and nationality do not match the listed subject."
  }'

{
  "_id": "68bbd741f4c6f683f94ca211",
  "projection": {
    "state": "FALSE_POSITIVE",
    "version": 2,
    "latestAttemptId": "68bbd741f4c6f683f94ca212",
    "accountRestricted": false
  },
  "decisions": [
    {
      "disposition": "FALSE_POSITIVE",
      "reason": "Date of birth and nationality do not match the listed subject.",
      "createdAt": "2026-08-12T10:22:14.000Z"
    }
  ]
}

​
Dispositions

ValueUse
FALSE_POSITIVEResolve a returned candidate as a false positive.
TRUE_POSITIVE_BLOCKConfirm a returned candidate and block the linked account when one exists.
CLEARED_AFTER_REVIEWClear a reviewable zero-candidate hold.
KEEP_ON_HOLDKeep a reviewable zero-candidate case pending.
ESCALATEDEscalate the case.
ACCEPTED_RISKAccept documented risk until a future review date.
UNBLOCKRestore an account that has an active sanctions restriction.
409 Conflict means expectedVersion is stale. Retrieve the case and reassess it before retrying.