Skip to main content
GET
Retrieve Agent Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response id (resp_<...>)

Response

JSON snapshot of the response.

Non-streaming response returned when stream is false

created_at
integer<int64>
required

Unix timestamp when the response was created

id
string
required

Unique identifier for the response

model
string
required

Model used for generation

object
enum<string>
required

Object type identifier

Available options:
response
output
(MessageOutputItem · object | SearchResultsOutputItem · object | ImageSearchResultsOutputItem · object | FetchUrlResultsOutputItem · object | FinanceResultsOutputItem · object | PeopleSearchResultsOutputItem · object | FunctionCallOutputItem · object | SandboxResultsOutputItem · object | McpListToolsOutputItem · object | McpCallOutputItem · object | McpApprovalRequestOutputItem · object | ToolSearchOutputItem · object)[]
required

Array of output items (messages, search results, tool calls)

status
enum<string>
required

Status of the response

Available options:
completed,
failed,
incomplete,
in_progress,
queued,
cancelled
error
ErrorInfo · object

Error details if the response failed

preset
string

Preset and version that ran this response, as name@<version> (e.g., "fast@2026-09-29.0"). Present only when the request used a preset. Streams resumed with starting_after omit it. For an alias, this is the preset and version that the alias selects. Send a value with a version as the request preset to run that configuration again. A released version can receive bug-fix patches, so sending it back runs that version as currently patched. A value without a version is the bare preset name: the run was created before preset versions, or was served without versions. Sending it runs the active version.

usage
ResponsesUsage · object

Token usage and cost information