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 |
|---|---|---|
decision_id | string | Unique identifier for the decision. |
risk_score | integer | Integer from 0 to 99. Higher is more suspicious. |
risk_level | string | Bucket derived from risk_score: low, medium, or high. |
suggested_action | string | What we recommend: allow, challenge, or deny. |
risk_setting | string | Which risk setting was active at the time. |
decided_at | 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 decision_id 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.