Decisions
What a decision is and what you get back for each one.
A decision is the record StaySignals returns from one POST /v1/risk call. You make one decision per booking attempt.
Each decision is immutable. Once StaySignals has scored a booking and returned a response, that decision — its score, level, suggested action, and the risk setting it was scored under — does not change. Later changes to your risk setting do not rewrite past decisions.
What you get back
Six fields, always the same shape:
| Field | Type | What it is |
|---|---|---|
decisionId | string | Unique identifier for the decision. |
riskScore | integer | Integer from 0 to 99. Higher is more suspicious. |
riskLevel | string | Bucket derived from riskScore: low, medium, or high. |
suggestedAction | string | What we recommend: allow or deny. |
riskSetting | string | Which risk setting was active at the time — one of maximizeProtection, balanced, maximizeRevenue. |
decidedAt | string | ISO 8601 timestamp of when we scored the booking. |
See POST /v1/risk for the full reference.
How to use the decision ID
Store decisionId on the order record. It's the only way to reconnect a booking to its decision when someone needs to audit it later — a customer disputing a deny, an operations team reviewing a batch, or your own engineers debugging a routing change.