Get decision
GET
/v1/decisions/{slot_id}ADVANCEDCall this after job creation only for advanced flows. Filled decisions include placement.render so the hosted renderer can own media, sizing, click, and beacon behavior.
AUTH
Secret key or browser activation token
CONTENT TYPE
application/json
STATUS
Advanced
Request parameters
- slot_id
- string
- Required
- Slot ID returned from POST /v1/jobs.
- wait_ms
- integer
- Optional
- Optional long-poll wait time in milliseconds.
| Name | Type | Required | Description |
|---|---|---|---|
| slot_id | string | Required | Slot ID returned from POST /v1/jobs. |
| wait_ms | integer | Optional | Optional long-poll wait time in milliseconds. |
Returns
- status
- string
- Decision state, usually pending, ready, or no_fill.
- placement
- object | null
- Hosted-render placement descriptor when a fill is ready.
- placement.render
- object
- Hosted frame descriptor with frame_url, script_url, media_type, dimensions, label, sponsor, and click URL.
- decision
- object | null
- Canonical decision payload retained for compatibility and debugging.
| Name | Type | Description |
|---|---|---|
| status | string | Decision state, usually pending, ready, or no_fill. |
| placement | object | null | Hosted-render placement descriptor when a fill is ready. |
| placement.render | object | Hosted frame descriptor with frame_url, script_url, media_type, dimensions, label, sponsor, and click URL. |
| decision | object | null | Canonical decision payload retained for compatibility and debugging. |
Errors
CODESTATUSWHEN IT HAPPENS
unauthorized401Missing auth.
not_found404Slot does not exist or belongs to another project.
rate_limited429Polling rate exceeded.