# Get ask response by ID

URL: /en/docs/api/v1/ask/id/get
Last Updated: 2026-07-30T21:15:44.995Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/ask/{id}

**Get ask response by ID**

Retrieve the latest ask response by ID.

If the ask is still in progress, the endpoint returns the persisted in-progress payload.
If the downstream job has reached a terminal state, the terminal result is returned.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | Ask response identifier |

**Responses:**

- `200` - Ask response retrieved successfully
  - `id` (string, required): Ask response identifier.
  - `object` (enum: response, required): Object type.
  - `status` (enum: in_progress | completed | failed | incomplete, required): Current status of the ask response.
  - `created_at` (integer, required): Unix timestamp (seconds) when the ask response was created.
  - `output` (array of AskOutputMessage (object)): Assistant output messages (present when completed with output).
    - `type` (enum: message, required)
    - `id` (string, required)
    - `role` (enum: assistant, required)
    - `status` (enum: completed, required)
    - `content` (array of AskOutputText (object), required)
      - `type` (enum: output_text, required)
      - `text` (string, required)
  - `usage` (AskUsage (object))
    - `input_tokens` (integer, required)
    - `output_tokens` (integer, required)
    - `total_tokens` (integer)
  - `error` (AskError (object))
    - `type` (string, required)
    - `code` (string, required)
    - `message` (string, required)

  Example (Ask response still in progress):
  
  ```json
  {
  "id": "ask_1",
  "object": "response",
  "status": "in_progress",
  "created_at": 1771920000
}
  ```

  Example (Ask response completed):
  
  ```json
  {
  "id": "ask_1",
  "object": "response",
  "status": "completed",
  "created_at": 1771920000,
  "output": [
    {
      "type": "message",
      "id": "msg_ask1",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Our uptime SLA is 99.9%."
        }
      ]
    }
  ]
}
  ```
- `400` - Invalid ask ID
  - `error` (string)
  - `details` (object)
- `401` - Unauthorized
  - `error` (string)

  Example (unauthorized):
  
  ```json
  {
  "error": "Unauthorized"
}
  ```

  Example (token_expired):
  
  ```json
  {
  "error": "Token expired"
}
  ```
- `404` - Ask response not found
  - `error` (string)
- `500` - Failed to load ask response
  - `error` (string)

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/ask/ask_1" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```