responses

Retrieve a model response

Changed on

Retrieves a tenant-scoped stored Responses API response.

get/api/v1/responses/{response_id}

Request

Path parameters

response_idstring required
Example:resp_123

Identifier of the stored response.

Headers

X-Organization-Idstring

Required for JWT authentication. API keys are already bound to an organization.

Response

The stored Responses API response.

idstring required
object'response' required
created_atinteger

Unix timestamp (in seconds) when the response was created.

status'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete' required
modelstring required

Public name of the model that generated the response.

output_textstring required

The text of every output_text part in output, joined. Reasoning and tool calls are excluded.

previous_response_idstring nullable

The response this one continues, if any.

storeboolean

Whether the response is stored for later retrieval.

metadataobject nullable

Example response

{
  "id": "resp_123",
  "object": "response",
  "created_at": 1750000000,
  "status": "completed",
  "model": "qwen3.5-397b",
  "output": [
    {
      "type": "message",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Once upon a time, a unicorn drifted to sleep on a cloud."
        }
      ],
      "name": "get_weather",
      "arguments": "{\"city\":\"Paris\"}",
      "call_id": "call_123",
      "server_label": "docs"
    }
  ],
  "output_text": "Once upon a time, a unicorn drifted to sleep on a cloud.",
  "error": {
    "code": "server_error",
    "message": "The model provider could not complete the request."
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "usage": {
    "input_tokens": 36,
    "output_tokens": 87,
    "total_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status