---
title: "Retrieve response"
method: GET
path: "/v3/router/responses/{response_id}"
tags: ["Responses"]
---

# Retrieve response

`GET /v3/router/responses/{response_id}`

Retrieves a previously created response by its ID.

## Path parameters

- `response_id` string, required — The ID of the response to retrieve

## Response `200`

Response retrieved successfully.

- object
  - `background` boolean, required
  - `completed_at` integer, nullable, required
  - `conversation` ConversationParam
    - `id` string, required
  - `created_at` integer, required
  - `error` ResponseError, required
    - `code` string, required
    - `message` string, required
  - `frequency_penalty` number, double, required
  - `id` string, required
  - `incomplete_details` IncompleteDetails, required
    - `reason` string, required
  - `input` unknown[], nullable, required — Array of input items (messages, function call outputs, etc.)
    - unknown
  - `instructions` string, nullable, required
  - `max_output_tokens` integer, nullable, required
  - `max_tool_calls` integer, nullable, required
  - `memory` MemoryParam
    - `entity_id` string, required
  - `metadata` object, required — Developer-defined key-value pairs attached to the response (OpenAI spec: Map<string, string>).
  - `model` string, required
  - `object` string, required — Always "response"
  - `output` unknown[], nullable, required — Array of output items (messages, function calls, reasoning, etc.)
    - unknown
  - `parallel_tool_calls` boolean, required
  - `presence_penalty` number, double, required
  - `previous_response_id` string, nullable, required
  - `prompt_cache_key` string, nullable, required
  - `prompt_cache_retention` string, nullable, required
  - `reasoning` Reasoning, required
    - `effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' — Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
    - `summary` 'concise' | 'detailed' | 'auto' | 'null', nullable — The format of the reasoning summary returned by the model.
  - `safety_identifier` string, nullable, required
  - `service_tier` 'auto' | 'default' | 'flex' | 'fast' | 'scale' | 'priority', required
  - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'incomplete', required
  - `store` boolean, required
  - `telemetry` ResponseTelemetry
    - `span_id` string, required
    - `trace_id` string, required
  - `temperature` number, double, required
  - `text` unknown, required
  - `tool_choice` unknown, required
  - `tools` unknown[], nullable, required — Array of tool configurations used in this response
    - unknown
  - `top_k` integer — Only sample from the top K options for each subsequent token. Present only when set on the request.
  - `top_logprobs` integer, required
  - `top_p` number, double, required
  - `truncation` 'disabled' | 'auto', required
  - `usage` PublicUsage, required
    - `input_cost` number, double — Cost (USD) of input tokens. Present when billing was computed for this response.
    - `input_tokens` integer, required
    - `input_tokens_details` InputTokensDetails, required
      - `cache_creation_1h_tokens` integer
      - `cache_creation_5m_tokens` integer
      - `cache_creation_tokens` integer, required
      - `cache_write_tokens` integer, required
      - `cached_tokens` integer, required
    - `output_cost` number, double — Cost (USD) of output tokens. Present when billing was computed for this response.
    - `output_tokens` integer, required
    - `output_tokens_details` OutputTokensDetails, required
      - `reasoning_tokens` integer, required
    - `total_cost` number, double — Total cost (USD) of the response. Present when billing was computed for this response.
    - `total_tokens` integer, required
    - `web_search_requests` integer
  - `user` string, nullable, required
  - `variables` object

## Other responses

- `404` — Response not found.

---

[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/revisions/f7a624eccddb/schema)