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

# Retrieve a response

`GET /responses/{response_id}`

## Path parameters

- `response_id` string, required

## Response `200`

The response object.

- ResponseObject
  - `id` string, required
  - `object` 'response', required
  - `created_at` integer, required
  - `status` 'pending' | 'running' | 'failed' | 'completed' | 'cancelled', required
  - `model` string, required
  - `input` union — Text input, plus image input (input_image) on multimodal models. Audio, files, and item references are not currently supported.
    - string
    - ResponseInputMessage[]
      - `role` 'system' | 'user' | 'assistant' | 'tool' | 'function', required
      - `content` union, required
        - string
        - union[]
          - union
            - ResponseInputTextPart
              - …
            - ResponseInputImagePart — Image content part. Image input is supported only on multimodal models; see the Models page.
              - …
      - `name` string
      - `tool_calls` object[]
      - `tool_call_id` string
      - `function_call` object
    - ResponseInputObject
      - `messages` ResponseInputMessage[], required
        - `role` 'system' | 'user' | 'assistant' | 'tool' | 'function', required
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `name` string
        - `tool_calls` object[]
        - `tool_call_id` string
        - `function_call` object
  - `output` union
    - string
    - object[]
    - object
  - `error` object, nullable
  - `incomplete_details` object, nullable
  - `max_output_tokens` integer, nullable
  - `reasoning` object
  - `text` ResponseTextConfiguration
    - `format` union, required
      - ResponseTextFormat
        - `type` 'text', required
      - ResponseJsonSchemaFormat
        - `type` 'json_schema', required
        - `name` string, required
        - `description` string
        - `schema` object
        - `strict` boolean
  - `store` boolean
  - `temperature` number
  - `top_p` number
  - `parallel_tool_calls` boolean
  - `tool_choice` union
    - string
    - object
  - `tools` object[]
  - `truncation` union
    - string
    - object
  - `usage` ResponseUsage, required
    - `input_tokens` integer, required
    - `input_tokens_details` ResponseUsageDetails, required
      - `cached_tokens` integer, required
      - `reasoning_tokens` integer, required
    - `output_tokens` integer, required
    - `output_tokens_details` ResponseUsageDetails, required
      - `cached_tokens` integer, required
      - `reasoning_tokens` integer, required
    - `total_tokens` integer, required
    - `prompt_tokens` integer
    - `completion_tokens` integer
  - `user` string, nullable
  - `metadata` object, required

## Other responses

- `401` — Authentication error.
- `404` — Response not found.
- `500` — Server error.

---

[API](https://skmtc.dev/sailresearch/apis/sail-api.md) · [All operations](https://skmtc.dev/sailresearch/apis/sail-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sailresearch/sail-api/revisions/c2a783d507f9/schema)