Retrieve response

curl https://router.toqan.ai/eu/v3/router/responses/resp_01KP6GDNJY5B0TT0R35KS23PYV \
  -H "Authorization: Bearer $TOQAN_API_KEY"

{
  "id": "resp_01KP6GDNJY5B0TT0R35KS23PYV",
  "object": "response",
  "created_at": 1776187529,
  "completed_at": 1776187529,
  "status": "completed",
  "model": "openai/gpt-6-astra",
  "input": [
    {
      "type": "message",
      "id": "msg_01KP6GDNK0TXBVMD3N5BWZ285J",
      "role": "user",
      "content": [
        { "type": "input_text", "text": "What time is it?" }
      ]
    }
  ],
  "output": [
    {
      "type": "orq:current_date",
      "id": "msg_01kp6gdppk31xp6qc1z92x132p",
      "call_id": "fc_888c598a-b519-421a-9904-e5f0e8c34a53",
      "name": "current_date",
      "status": "completed",
      "result": {
        "currentDate": "2026-04-14T17:25:29.175Z"
      }
    },
    {
      "type": "message",
      "id": "msg_01KP6GDPP6D57H9G7VVFKFW07H",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "It's currently 17:25 UTC (2026‑04‑14).",
          "annotations": []
        }
      ]
    }
  ],
  "tools": [
    { "type": "orq:current_date" }
  ],
  "usage": {
    "input_tokens": 352,
    "output_tokens": 126,
    "total_tokens": 478,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_creation_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 76
    }
  }
}

GET

router

responses

{response_id}

curl https://router.toqan.ai/eu/v3/router/responses/resp_01KP6GDNJY5B0TT0R35KS23PYV \
  -H "Authorization: Bearer $TOQAN_API_KEY"

{
  "id": "resp_01KP6GDNJY5B0TT0R35KS23PYV",
  "object": "response",
  "created_at": 1776187529,
  "completed_at": 1776187529,
  "status": "completed",
  "model": "openai/gpt-6-astra",
  "input": [
    {
      "type": "message",
      "id": "msg_01KP6GDNK0TXBVMD3N5BWZ285J",
      "role": "user",
      "content": [
        { "type": "input_text", "text": "What time is it?" }
      ]
    }
  ],
  "output": [
    {
      "type": "orq:current_date",
      "id": "msg_01kp6gdppk31xp6qc1z92x132p",
      "call_id": "fc_888c598a-b519-421a-9904-e5f0e8c34a53",
      "name": "current_date",
      "status": "completed",
      "result": {
        "currentDate": "2026-04-14T17:25:29.175Z"
      }
    },
    {
      "type": "message",
      "id": "msg_01KP6GDPP6D57H9G7VVFKFW07H",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "It's currently 17:25 UTC (2026‑04‑14).",
          "annotations": []
        }
      ]
    }
  ],
  "tools": [
    { "type": "orq:current_date" }
  ],
  "usage": {
    "input_tokens": 352,
    "output_tokens": 126,
    "total_tokens": 478,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_creation_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 76
    }
  }
}

Guia relacionado: guia da Responses API. Consulte o guia da Responses API para um passo a passo com exemplos.

Recupera uma resposta criada anteriormente pelo seu ID. A resposta precisa ter sido criada com store: true (o padrão).

curl https://router.toqan.ai/eu/v3/router/responses/resp_01KP6GDNJY5B0TT0R35KS23PYV \
  -H "Authorization: Bearer $TOQAN_API_KEY"

{
  "id": "resp_01KP6GDNJY5B0TT0R35KS23PYV",
  "object": "response",
  "created_at": 1776187529,
  "completed_at": 1776187529,
  "status": "completed",
  "model": "openai/gpt-6-astra",
  "input": [
    {
      "type": "message",
      "id": "msg_01KP6GDNK0TXBVMD3N5BWZ285J",
      "role": "user",
      "content": [
        { "type": "input_text", "text": "What time is it?" }
      ]
    }
  ],
  "output": [
    {
      "type": "orq:current_date",
      "id": "msg_01kp6gdppk31xp6qc1z92x132p",
      "call_id": "fc_888c598a-b519-421a-9904-e5f0e8c34a53",
      "name": "current_date",
      "status": "completed",
      "result": {
        "currentDate": "2026-04-14T17:25:29.175Z"
      }
    },
    {
      "type": "message",
      "id": "msg_01KP6GDPP6D57H9G7VVFKFW07H",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "It's currently 17:25 UTC (2026‑04‑14).",
          "annotations": []
        }
      ]
    }
  ],
  "tools": [
    { "type": "orq:current_date" }
  ],
  "usage": {
    "input_tokens": 352,
    "output_tokens": 126,
    "total_tokens": 478,
    "input_tokens_details": {
      "cached_tokens": 0,
      "cache_creation_tokens": 0
    },
    "output_tokens_details": {
      "reasoning_tokens": 76
    }
  }
}

Autorizações

Authorization

string

header

obrigatório

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

Parâmetros de caminho

response_id

string

obrigatório

The ID of the response to retrieve

Resposta

Response retrieved successfully.

background

boolean

obrigatório

completed_at

integer<int64> | null

obrigatório

created_at

integer<int64>

obrigatório

error

object | null

obrigatório

Show child attributes

frequency_penalty

number<double>

obrigatório

string

obrigatório

incomplete_details

object | null

obrigatório

Show child attributes

input

any[] | null

obrigatório

Always null. Retained for compatibility with older SDKs; input content is not returned.

instructions

string | null

obrigatório

max_output_tokens

integer<int64> | null

obrigatório

max_tool_calls

integer<int64> | null

obrigatório

metadata

object

obrigatório

Developer-defined key-value pairs attached to the response (OpenAI spec: Map<string, string>).

Show child attributes

model

string

obrigatório

object

string

obrigatório

Always "response"

output

any[] | null

obrigatório

Array of output items (messages, function calls, reasoning, etc.)

parallel_tool_calls

boolean

obrigatório

presence_penalty

number<double>

obrigatório

previous_response_id

string | null

obrigatório

prompt_cache_key

string | null

obrigatório

prompt_cache_options

object | null

obrigatório

Show child attributes

prompt_cache_retention

string | null

obrigatório

reasoning

object | null

obrigatório

Show child attributes

safety_identifier

string | null

obrigatório

service_tier

enum<string>

obrigatório

Opções disponíveis:

auto,

default,

flex,

fast,

ultrafast,

scale,

priority

status

enum<string>

obrigatório

Opções disponíveis:

queued,

in_progress,

completed,

failed,

incomplete

store

boolean

obrigatório

temperature

number<double>

obrigatório

text

any

obrigatório

Text output configuration including format and verbosity

tool_choice

any

obrigatório

Tool choice setting: "auto", "none", "required", or a specific function

tools

any[] | null

obrigatório

Array of tool configurations used in this response

top_logprobs

integer<int64>

obrigatório

top_p

number<double>

obrigatório

truncation

enum<string>

obrigatório

Opções disponíveis:

disabled,

auto

usage

object | null

obrigatório

Show child attributes

user

string | null

obrigatório

conversation

object

Show child attributes

memory

object

Show child attributes

telemetry

object

OpenTelemetry trace and span identifiers for this response.

Show child attributes

top_k

integer<int64>

Only sample from the top K options for each subsequent token. Present only when set on the request.

variables

object

Show child attributes

Clientes HTTP

APIs da plataforma

APIs de gerenciamento

Autorizações

Parâmetros de caminho

Resposta