Skip to main content
GET
/
v1
/
agent
/
runs
/
{run_id}
Poll an agent run
curl --request GET \
  --url https://tako.com/api/v1/agent/runs/{run_id} \
  --header 'X-API-Key: <api-key>'
{
  "run_id": "<string>",
  "created_at": "<string>",
  "object": "agent.run",
  "thread_id": "<string>",
  "completed_at": "<string>",
  "result": {
    "answer": "<string>",
    "cards": [
      {
        "card_id": "<string>",
        "title": "<string>",
        "description": "<string>",
        "semantic_description": "<string>",
        "webpage_url": "<string>",
        "image_url": "<string>",
        "embed_url": "<string>",
        "sources": [
          {
            "source_name": "S&P Global",
            "source_description": "S&P Global is a US-based financial data and analytics company that provides products and services to the financial industry.",
            "source_index": "tako",
            "url": "https://xignite.com",
            "source_text": "Domestic (28.1%) $154,061,981 | International (71.9%) $394,144,531 | Worldwide $548,206,512. Release Date Nov 7, 2025. Distributor 20th Century Studios."
          }
        ],
        "methodologies": [
          {
            "methodology_name": "Where the Data Comes From - S&P Global",
            "methodology_description": "The financial metrics are collected from S&P Global, where information is sourced from original regulatory filings, press releases, and subsequent restatements. Data points, including over 5,000 financial, supplemental, segment, ratio, and industry-specific items, are standardized across over 180,000 companies to ensure consistency and comparability across different reporting formats. This comprehensive and methodical process enables robust historical analysis and back-testing by seamlessly integrating diverse financial datasets while preserving the granularity of the original reports."
          }
        ],
        "source_indexes": [],
        "card_type": "<string>",
        "content": {
          "cost": 0,
          "data": "<string>",
          "total_rows": 123,
          "truncated": false
        },
        "relevance_score": 123
      }
    ],
    "web_results": [
      {
        "title": "<string>",
        "url": "<string>",
        "snippet": "<string>",
        "source_name": "<string>",
        "publish_date": "<string>",
        "content": {
          "cost": 0,
          "data": "<string>",
          "total_rows": 123,
          "truncated": false
        },
        "citation_number": 123
      }
    ],
    "request_id": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Notes

  • Poll with the run_id returned by Dispatch a run. status progresses queuedrunningcompleted / failed; the result is populated once status is completed.
  • To resume or tail the run as a live Server-Sent Events stream, send Accept: text/event-stream. Use starting_after (or the Last-Event-ID header) to replay only events whose seq is greater than a value you’ve already seen. See the Agent guide.

Authorizations

X-API-Key
string
header
required

Path Parameters

run_id
string
required

Run ID returned by POST /v1/agent/runs

Query Parameters

starting_after
integer

SSE resume cursor (Accept: text/event-stream only). Replay events with seq strictly greater than this value. Equivalent to the Last-Event-ID header.

Required range: x >= 0

Response

Current state of the agent run. With Accept: text/event-stream, resumes/tails the run as an SSE stream of AgentStreamEnvelope events (use starting_after or Last-Event-ID to resume); if the stream ends without an agent_result event, poll this endpoint with Accept: application/json for terminal status.

The run resource returned by dispatch (202) and poll (GET).

run_id
string
required
status
enum<string>
required
Available options:
queued,
running,
completed,
failed
created_at
string
required
object
string
default:agent.run
Allowed value: "agent.run"
thread_id
string | null
completed_at
string | null
result
AgentResult · object

Final agent output. answer is markdown; cards reuse the sibling TakoCard.

error
ErrorObject · object