---
title: "GET /v1/responses/{id}"
method: GET
path: "/v1/responses/{id}"
---

# GET /v1/responses/{id}

`GET /v1/responses/{id}`

## Request

- Base URL: `https://nano-gpt.com/api`
- URL: `https://nano-gpt.com/api/v1/responses/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Retrieve a stored response by ID

## Path parameters

- `id` string, required

## Response `200`

Stored response

- ResponsesResponse: Response object returned by the Responses API
  - `id` string
  - `object` string
  - `created_at` integer
  - `model` string
  - `status` 'queued' | 'in_progress' | 'completed' | 'incomplete' | 'failed' | 'cancelled'
  - `output` object[]
  - `output_text` string
  - `usage` object
  - `error` object
  - `incomplete_details` object
  - `metadata` object
  - `service_tier` string
  - `advisor` AdvisorResponseMetadata: Advisor orchestration outcome. Top-level usage and pricing aggregate billable phases that returned usage, including an HTTP-success advisor phase whose output was unusable; the optional per-phase objects provide reconciliation detail.
    - `id` string, required
    - `mode` 'auto' | 'required', required
    - `executor_model` string, required
    - `advisor_model` string, required
    - `requested` boolean, required: Whether the executor emitted the internal consultation request.
    - `consulted` boolean, required: Whether an advisor child call was attempted.
    - `successful` boolean, required: Whether the advisor returned usable advice.
    - `consultation_count` 0 | 1, required
    - `max_uses` 1, required
    - `status` 'not_used' | 'completed' | 'failed', required
    - `error` string: Present when consultation failed but the executor could continue.
    - `usage` AdvisorPhaseBreakdown
      - `executor` object
      - `advisor` object
      - `continuation` object
      - `total` object
    - `pricing` AdvisorPhaseBreakdown
      - `executor` object
      - `advisor` object
      - `continuation` object
      - `total` object

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found - Response does not exist

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/v1/responses/:id/get.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)