---
title: "Get agent response"
method: GET
path: "/agents/responses/{id}"
tags: ["agents"]
---

# Get agent response

`GET /agents/responses/{id}`

Get the status and result of an agent response by ID. Used to poll background responses.

## Path parameters

- `id` string, required

## Response `200`

Response found

- AgentResponse
  - `id` string, required — Response ID
  - `object` 'response', required
  - `created_at` integer, required — Unix timestamp of creation
  - `completed_at` integer, nullable, required — Unix timestamp of completion
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'incomplete', required
  - `model` string, required — Model used
  - `output` AgentOutputItem[], required — Output items
    - union
      - AgentAssistantMessage
        - `id` string, required — Message ID
        - `type` 'message', required
        - `role` 'assistant', required
        - `content` AgentOutputTextContent[], required
          - `type` 'output_text', required
          - `text` string, required — The output text
        - `status` 'in_progress' | 'completed' | 'incomplete', required
      - AgentFunctionCall
        - `id` string, required — Function call ID
        - `type` 'function_call', required
        - `call_id` string, required — Tool call ID
        - `name` string, required — Function name
        - `arguments` string, required — JSON-encoded arguments
        - `status` 'in_progress' | 'completed' | 'incomplete', required
  - `usage` AgentUsage, required
    - `input_tokens` integer, required — Input tokens used
    - `output_tokens` integer, required — Output tokens generated
    - `total_tokens` integer, required — Total tokens
  - `error` object, nullable, required — Error details if failed
    - `code` string, required
    - `message` string, required
  - `background` boolean, required — Whether running in background
  - `instructions` string, nullable, required — System instructions used
  - `previous_response_id` string, nullable, required — Previous response ID
  - `metadata` object, nullable, required — Request metadata

## Other responses

- `400` — Invalid response ID
- `404` — Response not found

## Changes

- **2026-02-02** `3739e781a93e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/agents/responses/:id/get.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/9d53933ba12e?raw)