---
title: "List Ask AI history"
method: GET
path: "/api/sites/{id}/ask-ai/history"
tags: ["Sites"]
---

# List Ask AI history

`GET /api/sites/{id}/ask-ai/history`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/sites/{id}/ask-ai/history`
- Auth: API key in cookie `hk_token`

Returns audit-safe Ask AI run summaries for the selected site. The response includes run metadata, hashes, usage, and validated summary counts only; raw prompts, full answers, provider payloads, headers, and credentials are not returned. Requires a human dashboard session with site.view; API client bearer tokens and shared dashboard routes are rejected.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Ask AI history

- AskAIHistoryResponse
  - `entries` AskAIHistoryEntry[], required
    - `action_count` integer, required
    - `action_types` string[], required
    - `answer_chars` integer, required
    - `chart_count` integer, required
    - `chart_types` string[], required
    - `citation_count` integer, required
    - `created_at` string, date-time, required
    - `error_category` string
    - `input_hash` string: SHA-256 hash of the audit-safe request snapshot.
    - `input_tokens` integer, required
    - `lifecycle_event_count` integer, required
    - `model` string
    - `output_hash` string: SHA-256 hash of the validated Ask AI output.
    - `output_tokens` integer, required
    - `provider` string
    - `run_id` string, uuid, required
    - `status` 'reserved' | 'success' | 'failure', required
    - `template_version` string
    - `tool_call_count` integer, required
    - `tool_names` string[], required
    - `total_tokens` integer, required
  - `has_more` boolean, required
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required

## Other responses

- `400`: Invalid Ask AI history request
- `403`: Dashboard session required or forbidden
- `409`: Ask AI unavailable

---

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