---
title: "Poll an ask for its answer"
method: GET
path: "/v1/ask/{id}"
tags: ["Agent"]
---

# Poll an ask for its answer

`GET /v1/ask/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/ask/{id}`
- Auth: HTTP bearer

Poll a previously-started ask. Tenant-isolated: an ask that belongs to a different
workspace reads as not found. While the turn runs the response is
`{ "status": "processing" }` plus `conversation_id`; once completed it carries:

- `answer`: the full answer in markdown, citations inline as links.
- `citations[]`: the same citations structured: source `document_id`, the cited
  `quote`, whether it grounds a captured `field` or a verbatim `quote`, the source
  `filename` when resolved, and a deep `app_url` that opens the document with the
  span highlighted.
- `cards[]` and `artifacts[]`: the generative UI cards and artifacts the turn
  produced, when any.
- `tool_calls`: how many tool invocations the turn ran, an audit-trail count.
- `verification`: the post-answer verification verdict: a fast model re-checks the
  answer's claims against the turn's own tool evidence (`supported` | `issues` |
  `unverifiable`, with check counts and an optional correction). Treat `issues` as a
  review pointer, not ground truth.
- `usage`: token count and the flat `credits_charged`.

## Path parameters

- `id` string, uuid, required

## Response `200`

The ask's current state (processing, completed, or error).

- object
  - `ask_id` string, uuid
  - `status` 'processing' | 'completed' | 'error'
  - `poll_url` string
  - `conversation_id` string, uuid, nullable
  - `answer` string: Markdown answer (present when completed).
  - `citations` object[]
    - `quote` string
    - `document_id` string, uuid
    - `kind` 'field' | 'quote'
    - `reference` string
    - `filename` string, nullable
    - `app_url` string
  - `cards` object[]: Generative UI cards the turn produced (present when completed).
  - `artifacts` object[]
    - `type` string
    - `id` string
    - `label` string
    - `link` string
  - `tool_calls` integer: Number of tool invocations the turn ran.
  - `verification` object, nullable
    - `verdict` 'supported' | 'issues' | 'unverifiable'
    - `checks_total` integer
    - `checks_unsupported` integer
    - `correction` string
  - `usage` object
    - `tokens` integer, nullable
    - `credits_charged` integer

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

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