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

# Retrieve response

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

## Request

- Base URL: `https://my.orq.ai`
- URL: `https://my.orq.ai/v3/router/responses/{response_id}`
- Auth: HTTP bearer

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_options` OpenAIPromptCacheOptions, required
    - `mode` 'implicit' | 'explicit'
    - `ttl` '30m' | '12h'
  - `prompt_cache_retention` string, nullable, required
  - `reasoning` Reasoning, required
    - `context` 'auto' | 'current_turn' | 'all_turns'
    - `effort` 'none' | 'instant' | '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' | 'ultrafast' | '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
      - `cache_write_tokens_details` CacheWriteTokensDetails
        - `ttl_12h_tokens` integer, required
        - `ttl_30m_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
    - `server_tool_use` ServerToolUseDetails
      - `advisor_requests` integer
      - `code_interpreter_sessions` integer
      - `datetime_requests` integer
      - `fusion_requests` integer
      - `image_generation_calls` integer
      - `search_models_requests` integer
      - `shell_commands` integer
      - `subagent_requests` integer
      - `tool_search_requests` integer
      - `web_fetch_requests` integer
      - `web_search_requests` integer
    - `speed` 'standard' | 'fast': Inference speed reported by Anthropic and used for billing.
    - `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.

## Changes

> 554 revisions in range; 71 not diffed.

- **2026-10-23** `0b4e519a544f`: 2 warning, 2 info
  - added the new `12h` enum value to the `prompt_cache_options/anyOf[#/components/schemas/OpenAIPromptCacheOptions]/ttl` response property for the response status `200`
  - added the new `instant` enum value to the `reasoning/anyOf[#/components/schemas/Reasoning]/effort` response property for the response status `200`
  - added the optional property `reasoning/anyOf[#/components/schemas/Reasoning]/context` to the response with the `200` status
  - added the optional property `usage/anyOf[#/components/schemas/PublicUsage]/input_tokens_details/cache_write_tokens_details` to the response with the `200` status
- **2026-10-23** `732aed62833a`: 1 warning, 2 info
  - removed the optional property `usage/anyOf[#/components/schemas/PublicUsage]/input_tokens_details/cache_write_tokens_details` from the response with the `200` status
  - removed the `12h` enum value from the `prompt_cache_options/anyOf[#/components/schemas/OpenAIPromptCacheOptions]/ttl` response property for the response status `200`
  - removed the `instant` enum value from the `reasoning/anyOf[#/components/schemas/Reasoning]/effort` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v3/router/responses/:response_id/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/928a71e92252?raw)