---
title: "List Response Proposals"
method: GET
path: "/api/response-proposals"
tags: ["response-proposals"]
---

# List Response Proposals

`GET /api/response-proposals`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/response-proposals`
- Auth: none declared

List reply proposals awaiting the caller's review.

Keyset-paginated, newest first (TOS-3280). Without ``cursor`` returns the
most recent page; pass the previous response's ``next_cursor`` to load
older ones. 400 on a malformed cursor.

## Query parameters

- `status` 'pending' | 'approved' | 'rejected' | 'expired' | 'canceled'
- `chat_id` string, uuid, nullable
- `responder_identity_id` string, uuid, nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- ResponseProposalListResponse: A keyset-paginated page of reply proposals (TOS-3280). ``next_cursor`` is ``None`` exactly when no older rows remain; pass it back as ``cursor`` to fetch the next page. A non-``None`` value IS the truncation signal - there is no separate ``truncated`` flag to check.
  - `proposals` ResponseProposalView[], required
    - `id` string, uuid, required
    - `chat_id` string, uuid, required
    - `responder_identity_id` string, uuid, required
    - `triggering_message_id` string, uuid, nullable, required
    - `candidate_text` string, required
    - `status` string, required
    - `resolved_by_identity_id` string, uuid, nullable, required
    - `resolved_message_id` string, uuid, nullable, required
    - `resolution_note` string, nullable, required
    - `created_at` string, date-time, required
    - `resolved_at` string, date-time, nullable, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thinqos/apis/thinqos-api.md) · [All operations](https://skmtc.dev/thinqos/apis/thinqos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinqos/apis/thinqos-api/revisions/5387b4ded614?raw)