---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/llm/openai_responses/types/interfaces/OpenAIResponsesResponseObject.md
description: >-
  The full `response` object — returned directly (non-streaming), or nested
  under a terminal streaming event.
---

# Interface: OpenAIResponsesResponseObject

Defined in: [src/batteries/llm/openai\_responses/types.ts:280](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L280)

The full `response` object — returned directly (non-streaming), or nested under a terminal streaming event.

## Indexable

```ts
[key: string]: unknown
```

## Properties

| Property                                                       | Type                                                                                               | Description                                                                             | Defined in                                                                                                                                              |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `created_at?`                 | `number`                                                                                           | Unix timestamp (seconds) when the response was created.                                 | [src/batteries/llm/openai\_responses/types.ts:286](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L286) |
|  `error?`                           | | { `code?`: `string`; `message?`: `string`; `type?`: `string`; } | `null`                     | Present when `status` is `'failed'`; the provider's error details.                      | [src/batteries/llm/openai\_responses/types.ts:300](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L300) |
|  `id?`                                 | `string`                                                                                           | The response's unique identifier.                                                       | [src/batteries/llm/openai\_responses/types.ts:282](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L282) |
|  `incomplete_details?` | | { `reason?`: `string`; } | `null`                                                            | Present when `status` is `'incomplete'`; explains why generation stopped early.         | [src/batteries/llm/openai\_responses/types.ts:298](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L298) |
|  `model?`                           | `string`                                                                                           | The model that generated the response.                                                  | [src/batteries/llm/openai\_responses/types.ts:290](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L290) |
|  `object?`                         | `string`                                                                                           | Object-type discriminator, typically `'response'`.                                      | [src/batteries/llm/openai\_responses/types.ts:284](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L284) |
|  `output?`                         | [`OpenAIResponsesOutputItem`](../type-aliases/OpenAIResponsesOutputItem.md)\[]                      | The ordered output items the model produced.                                            | [src/batteries/llm/openai\_responses/types.ts:292](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L292) |
|  `output_text?`               | `string`                                                                                           | Convenience concatenation of the response's output text, when the provider supplies it. | [src/batteries/llm/openai\_responses/types.ts:294](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L294) |
|  `status?`                         | | `"failed"` | `"completed"` | `"incomplete"` | `"in_progress"` | `"cancelled"` | `"queued"` | Terminal or in-flight lifecycle status of the response.                                 | [src/batteries/llm/openai\_responses/types.ts:288](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L288) |
|  `usage?`                           | [`OpenAIResponsesUsage`](OpenAIResponsesUsage.md)                                                  | Token-usage accounting for this response.                                               | [src/batteries/llm/openai\_responses/types.ts:296](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/openai_responses/types.ts#L296) |