OZozav
Decisions

Report what happened after a decision

Tells OZAV how the case ended. An outcome is recorded once: a second report returns 409 OUTCOME_ALREADY_RECORDED. Outcomes help OZAV measure and improve its rules.

post/decisions/{decision_id}/outcome

Request

  • Base URL
    https://developers.ozav.io/v2
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Path parameters

decision_idstring required

The decision id (ozav_dec_...).

Request body

outcome'confirmed_risk' | 'false_positive' | 'completed' | 'reversed' | 'chargeback' required
  • confirmed_risk - the risk was real.
  • false_positive - the flag was wrong.
  • completed - the operation went ahead and completed normally.
  • reversed - the operation was reversed or refunded.
  • chargeback - the operation ended in a chargeback.
notestring

Optional free text.

Response

The decision with its outcome.

idstring required

The decision id (ozav_dec_...).

object'decision' required

Always the literal decision.

type'name.match' | 'destination.ownership' | 'wallet.risk' | 'transaction.outbound' required

The decision type requested.

effect'ALLOW' | 'REVIEW' | 'DENY' required

ALLOW, REVIEW (a person should look) or DENY (OZAV holds the proof of the risk).

policy_versionstring required

The version of OZAV's rules that produced the verdict.

outcome'confirmed_risk' | 'false_positive' | 'completed' | 'reversed' | 'chargeback' | 'null' nullable required

The outcome you reported, or null.

outcome_atstring date-time nullable required

When the outcome was reported.

created_atstring date-time required

When the decision was made.

Changes

No recorded changes to this operation across all 1 revision of this API.