---
title: "List responses"
method: GET
path: "/responses"
tags: ["Response"]
---

# List responses

`GET /responses`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/responses`
- Auth: HTTP bearer

List all responses with pagination and filtering options.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'in_progress' | 'completed' | 'failed' | 'cancelled'
- `created_before` string, date
- `created_after` string, date

## Response `200`

List of responses

- ResponseList
  - `object` 'list': Object type identifier
  - `data` ResponseListItem[]: List of responses
    - `id` string, uuid: Unique identifier for the response
    - `object` 'response': Object type identifier
    - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled': Current status of the response
    - `created_at` integer: Unix timestamp of when the response was created
    - `model` string: The model used for the response
    - `instructions` string, nullable: The system instructions used
    - `usage` ResponseUsage: Token usage statistics for the response
      - `input_tokens` integer: Number of input tokens used
      - `output_tokens` integer: Number of output tokens generated
      - `total_tokens` integer: Total tokens used
  - `total` integer: Total number of responses matching the query
  - `limit` integer: Maximum number of responses returned
  - `offset` integer: Number of responses skipped

## Other responses

- `500`: An unexpected error occurred on the server

## Changes

- **2026-10-30** `23d3f240819f`: 1 info
  - added the optional property `code` to the response with the `500` status
- **2026-03-11** `1d5d6115c0d0`: 2 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2026-01-30** `2e7f65543b55`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/responses/get.md)

---

[API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)