---
title: "Check history"
method: GET
path: "/sites/{siteId}/citations/history"
---

# Check history

`GET /sites/{siteId}/citations/history`

## Request

- Base URL: `https://promvia.app/api/v1`
- URL: `https://promvia.app/api/v1/sites/{siteId}/citations/history`
- Auth: HTTP bearer

Per-check rows, filterable by engine; days 1-90 (default 30), limit 1-100 (default 50). Each row's sentiment carries sentimentSource (model / keyword / null), and observedQueries lists the web searches that engine ran for the answer (null = the engine does not expose them; [] = none ran).

## Path parameters

- `siteId` string, required

## Query parameters

- `engine` string
- `days` integer
- `limit` integer

## Response `200`

Check history

## Other responses

- `401`: Missing/invalid API key.
- `402`: API access requires a Pro or Agency plan.
- `403`: The key's account holds a seat in another workspace — API keys are owner credentials.
- `404`: Site not found (or not yours).
- `429`: Per-minute rate limit or the monthly request pool exceeded. A monthly-pool 429 names the limit and reset date in the body and X-RateLimit headers; the burst 429 just asks you to retry shortly.

---

[API](https://skmtc.dev/promvia/apis/promvia-api.md) · [All operations](https://skmtc.dev/promvia/apis/promvia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/promvia/apis/promvia-api/revisions/3f058e1d6016?raw)