---
title: "Retrieve a model response"
method: GET
path: "/api/v1/responses/{response_id}"
tags: ["responses"]
---

# Retrieve a model response

`GET /api/v1/responses/{response_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/adaptionlabs/apis/adaption-api/docs/api/v1/responses/:response_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a tenant-scoped stored Responses API response.

## Path parameters

- `response_id` string, required

## Headers

- `X-Organization-Id` string

## Response `200`

The stored Responses API response.

- ResponseObjectDto
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer: Unix timestamp (in seconds) when the response was created.
  - `status` 'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete', required
  - `model` string, required: Public name of the model that generated the response.
  - `output` ResponseOutputItemDto[], required: Items the model generated, in order.
    - `type` string, required: Item type, such as `message`, `reasoning`, `function_call`, `mcp_call` or `file_search_call`. Fields beyond the ones listed depend on the type.
    - `id` string: Identifier of the output item.
    - `status` string: Status of the item, such as `completed` or `in_progress`.
    - `role` 'assistant': Author of a `message` item.
    - `content` ResponseOutputContentDto[]: Content parts of a `message` item.
      - `type` string, required: Content part type: `output_text` for reply text, `refusal` for a refusal.
      - `text` string: The reply text, on an `output_text` part.
      - `refusal` string: The refusal message, on a `refusal` part.
      - `annotations` object[]: Citations into `text`, such as file citations from file search.
    - `name` string: Name of the tool called, on `function_call`, `mcp_call` and `mcp_approval_request` items.
    - `arguments` string: JSON-encoded arguments for the tool, on `function_call`, `mcp_call` and `mcp_approval_request` items.
    - `call_id` string: Identifier to answer a `function_call` with: send it back as the `call_id` of a `function_call_output` input item.
    - `server_label` string: Label of the MCP server, on `mcp_call`, `mcp_approval_request` and `mcp_list_tools` items.
    - `approval_request_id` string, nullable: The approval request this `mcp_call` answers, if it needed approval.
    - `output` string, nullable: What the tool returned, on an `mcp_call` item.
    - `error` string, nullable: Why the tool call failed, on `mcp_call` and `mcp_list_tools` items.
    - `tools` object[]: Tools the server offers, on an `mcp_list_tools` item.
    - `summary` object[]: Summary parts of a `reasoning` item, each with `type` and `text`.
    - `encrypted_content` string, nullable: Opaque reasoning state to replay in a later request, on a `reasoning` item.
    - `queries` string[]: Search queries, on a `file_search_call` item.
    - `results` object[], nullable: Matched chunks, on a `file_search_call` item.
  - `output_text` string, required: The text of every `output_text` part in `output`, joined. Reasoning and tool calls are excluded.
  - `error` ResponseErrorDto
    - `code` string, required
    - `message` string, required
  - `incomplete_details` ResponseIncompleteDetailsDto
    - `reason` string: Why the response is incomplete.
  - `usage` ResponseUsageDto
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `total_tokens` integer, required
    - `input_tokens_details` object
    - `output_tokens_details` object
  - `previous_response_id` string, nullable: The response this one continues, if any.
  - `store` boolean: Whether the response is stored for later retrieval.
  - `metadata` object, nullable

## Other responses

- `404`: The stored response was not found.

## Changes

- **2026-10-30** `11a9e00ac7bf`: 12 info
  - added the optional property `output/items/approval_request_id` to the response with the `200` status
  - added the optional property `output/items/arguments` to the response with the `200` status
  - added the optional property `output/items/call_id` to the response with the `200` status
  - added the optional property `output/items/encrypted_content` to the response with the `200` status
  - …8 more
- **2026-10-30** `2d313f8e0922`: 13 info
  - added the optional property `created_at` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
  - added the optional property `incomplete_details` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - …9 more
- **2026-10-29** `b38d4dc031db`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adaptionlabs/apis/adaption-api/changes/api/v1/responses/:response_id/get.md)

---

[API](https://skmtc.dev/adaptionlabs/apis/adaption-api.md) - [All operations](https://skmtc.dev/adaptionlabs/apis/adaption-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptionlabs/apis/adaption-api/revisions/d4cf908c19a0?raw)