---
title: "Get response"
method: GET
path: "/v2/agents/{agent_key}/responses/{task_id}"
tags: ["Agents"]
deprecated: true
---

# Get response

`GET /v2/agents/{agent_key}/responses/{task_id}`

> **Deprecated.**

Retrieves the current state of an agent response by task ID. Returns the response output, model information, token usage, and execution status. When the agent is still processing, the output array will be empty and status will be `in_progress`. Once completed, the response includes the full output, usage statistics, and finish reason.

## Path parameters

- `agent_key` string, required — The unique key identifier of the agent
- `task_id` string, required — The agent execution task ID returned from create response

## Response `200`

Response retrieved successfully. Returns the current state of the agent execution including output messages, model used, token usage, and status.

- GetAgentResponse — Response type from the get-response endpoint. Includes a status field indicating the current state of the agent execution.
  - `_id` string, required — The unique response ID
  - `task_id` string, required — The agent execution task ID
  - `output` AgentResponseMessage[], required — Array of messages from the agent execution
    - `messageId` string, required
    - `role` 'user' | 'agent' | 'tool' | 'system', required
    - `parts` union[], required
      - union
        - TextPart — A text content part containing plain text or markdown. Used for agent messages, user input, and text-based responses.
          - `kind` 'text', required
          - `text` string, required
        - ErrorPart — An error content part containing error information. Used when an error occurs during agent execution.
          - `kind` 'error', required
          - `error` string, required
          - `code` number
        - DataPart — A structured data part containing JSON-serializable key-value pairs. Used for passing structured information between agents and tools.
          - `kind` 'data', required
          - `data` object, required
          - `metadata` object
        - FilePart — A file content part that can contain either base64-encoded bytes or a URI reference. Used for images, documents, and other binary content in agent communications.
          - `kind` 'file', required
          - `file` union, required
            - object — Binary in base64 format. Check in the model's documentation for the supported mime types for the binary format.
              - …
            - object — File in URI format. Check in the model's documentation for the supported mime types for the URI format
              - …
          - `metadata` object
        - ToolCallPart — A tool invocation request from an agent. Contains the tool name, unique call ID, and arguments for the tool execution.
          - `kind` 'tool_call', required
          - `tool_name` string, required
          - `tool_call_id` string, required
          - `arguments` object, required
          - `thought_signature` string
          - `metadata` object
        - ToolResultPart — The result of a tool execution. Contains the tool call ID for correlation and the result data from the tool invocation.
          - `kind` 'tool_result', required
          - `tool_call_id` string, required
          - `result` unknown
          - `metadata` object
    - `metadata` object
  - `created_at` string, required — ISO timestamp of response creation
  - `model` string, required — Model used in provider/model format
  - `usage` object, nullable — Token usage from the agent execution
    - `completion_tokens` number — Number of tokens in the generated completion.
    - `prompt_tokens` number — Number of tokens in the prompt.
    - `total_tokens` number — Total number of tokens used in the request (prompt + completion).
    - `prompt_tokens_details` object, nullable
      - `cached_tokens` integer, nullable
      - `cache_creation_tokens` integer, nullable
      - `audio_tokens` integer, nullable — The number of audio input tokens consumed by the request.
    - `completion_tokens_details` object, nullable
      - `reasoning_tokens` number, nullable
      - `accepted_prediction_tokens` number, nullable
      - `rejected_prediction_tokens` number, nullable
      - `audio_tokens` integer, nullable — The number of audio output tokens produced by the response.
  - `finish_reason` 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'function_call' | 'max_iterations' | 'max_time' — The reason why the agent stopped generating
  - `pending_tool_calls` object[] — Tool calls awaiting user response (when finish_reason is function_call)
    - `id` string, required
    - `type` 'function', required
    - `function` object, required
      - `name` string
      - `arguments` string
  - `telemetry` Telemetry — Telemetry information for correlating the response with traces
    - `trace_id` string, required — The root trace ID for the agent execution
    - `span_id` string, required — The span ID of the agent execution within the trace
  - `status` 'in_progress' | 'completed' | 'failed', required — Current status of the agent response
  - `error` string — Error message when status is failed

## Other responses

- `404` — Response not found. The specified task ID does not exist for this agent or workspace.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/versions/1072e5ba28ab/schema)