---
title: "List my proposals (sent and received)"
method: GET
path: "/api/v1/proposals"
---

# List my proposals (sent and received)

`GET /api/v1/proposals`

## Request

- Base URL: `https://traydstar.com`
- URL: `https://traydstar.com/api/v1/proposals`
- Auth: HTTP bearer

## Response `200`

Proposals the account sent or received, newest first. Scope: read. Each proposal carries sent_by_agent (true when an agent key made it or countered with it); which key is never exposed.

- object
  - `proposals` Proposal[], required
    - `id` string, uuid, required
    - `proposer_id` string, uuid
    - `receiver_id` string, uuid
    - `proposer_listing_id` string, uuid, nullable
    - `receiver_listing_id` string, uuid
    - `message` string, nullable
    - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'WITHDRAWN' | 'COUNTERED' | 'EXPIRED', required
    - `counter_of` string, uuid, nullable
    - `counter_terms` object, nullable
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `sent_by_agent` boolean

## Other responses

- `default`: Error.

---

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