> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a response handler

> **Required scope:** read

**Required scope:** `read`

### Path parameters

<ParamField path="response_id" type="string" required>
  Response ID
</ParamField>

### Response

`object`

<ResponseField name="id" type="string" required />

<ResponseField name="object" type="string" required />

<ResponseField name="created_at" type="integer" required>
  Unix timestamp (seconds).
</ResponseField>

<ResponseField name="status" type="string" required />

<ResponseField name="model" type="string" required />

<ResponseField name="output" type="object[]" required>
  <Expandable title="output">
    <ResponseField name="type" type="string" required />

    <ResponseField name="id" type="string" required />

    <ResponseField name="status" type="string" required />

    <ResponseField name="role" type="string">
      Present on `message` items.
    </ResponseField>

    <ResponseField name="content" type="object[]">
      Present on `message` items.

      <Expandable title="content">
        <ResponseField name="type" type="string" />

        <ResponseField name="text" type="string" />

        <ResponseField name="annotations" type="object[]" />
      </Expandable>
    </ResponseField>

    <ResponseField name="call_id" type="string">
      Present on `function_call` items.
    </ResponseField>

    <ResponseField name="name" type="string">
      Present on `function_call` items.
    </ResponseField>

    <ResponseField name="arguments" type="string">
      JSON-encoded arguments string. Present on `function_call` items.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="output_text" type="string">
  Convenience concatenation of the output text. Omitted when there is none.
</ResponseField>

<ResponseField name="usage" type="object" required>
  <Expandable title="usage">
    <ResponseField name="input_tokens" type="integer" required />

    <ResponseField name="output_tokens" type="integer" required />

    <ResponseField name="total_tokens" type="integer" required />
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  Echoed request metadata. Omitted when absent.
</ResponseField>

<ResponseField name="previous_response_id" type="string">
  Omitted when absent.
</ResponseField>

<ResponseField name="x_nsr" type="object">
  Full recursive NSR payload. Present only when the response was created with `include_nsr_metadata`.
</ResponseField>

### Status codes

| Code  | Meaning                                                                                                                                                          |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200` | The stored response object, exactly as returned by `POST /v1/responses`.                                                                                         |
| `401` | Unauthorized — missing or invalid credentials                                                                                                                    |
| `403` | Forbidden — the key/token lacks the required scope                                                                                                               |
| `404` | Unknown `response_id` (or a response owned by another org). OpenAI-shaped error envelope: `&#123;'error': &#123;'message', 'type', 'param', 'code'&#125;&#125;`. |
| `429` | Rate limited — see Retry-After / X-RateLimit-Reset                                                                                                               |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.nsr.stateset.com/v1/responses/{response_id}' \
    --header "X-API-Key: $STATESET_NSR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "object": "string",
    "created_at": 1,
    "status": "pending",
    "model": "string",
    "output": [
      {
        "type": "standard",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "status": "pending",
        "role": "string",
        "content": [],
        "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "Two-Person Tent",
        "arguments": "string"
      }
    ],
    "output_text": "string",
    "usage": {
      "input_tokens": 1,
      "output_tokens": 1,
      "total_tokens": 1
    },
    "metadata": {},
    "previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "x_nsr": {}
  }
  ```
</ResponseExample>