Brand Alignment: fact history
GET /v1/brands/:brand_id/alignment/facts/:fact_id/history
Access is limited to the brands permitted by your credential. Requires read:alignment. Workspace API keys and signed-in MCP sessions are supported.
How AI has stated one fact across finished scans, oldest first, as the “Alignment over time” chart in a fact’s sheet shows it: up to 26 scans ending at scan_id. Only scans that asked the wording scan_id measured count: a fact’s earlier wording is trended as another fact.
Asky manages the monitoring questions. Responses include results without exposing generated question text.
Query parameters
| Parameter | Type | Description |
|---|---|---|
scan_id | uuid | The last scan to include, and the wording to trend, from the program endpoint. Defaults to the latest finished scan. |
models | string (repeatable) | Engine identifiers. Repeat this parameter to select multiple engines. |
markets | string (repeatable) | Country codes (DE) or one country and language (DE:de-DE). Repeat this parameter to select multiple markets. |
stream | string | dedicated for answers to Asky’s scan questions, ordinary for tracked-prompt answers that mention the brand, or all (the default). |
since | date | Only scans on or after this date (YYYY-MM-DD). |
by_engine | boolean | Also the outcome shares per engine. |
Response
The standard API envelope places the result in data, with request_id beside it at the top level.
| Field | Description |
|---|---|
fact | The fact’s id and its text as scan_id measured it. |
scans | Oldest first. Scans with no answer about the fact in the selection are left out. |
scans[].outcomes | aligned, contradicted and identity as shares of the answers about the fact that were assessed (value in percent with its numerator and denominator), the fact’s cards. |
scans[].outcomes_change | The change in percentage points since the scan before, per outcome. Null for the first scan. |
scans[].by_engine | With by_engine: the outcome shares per engine. |
A fact that is not part of scan_id returns not_found: “Not found.” The fact in one scan is the fact endpoint; every fact together is the history endpoint.