---
title: "List my handshakes"
method: GET
path: "/api/v1/handshakes"
---

# List my handshakes

`GET /api/v1/handshakes`

## Request

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

## Response `200`

Handshakes with payment/completion flags. Scope: read.

- object
  - `handshakes` Handshake[], required
    - `id` string, uuid, required
    - `proposal_id` string, uuid
    - `party_a_id` string, uuid
    - `party_b_id` string, uuid
    - `party_a_paid` boolean: Party A's side is settled (paid or covered).
    - `party_b_paid` boolean
    - `party_a_completed` boolean
    - `party_b_completed` boolean
    - `status` 'PENDING_PAYMENT' | 'ACTIVE' | 'DISPUTED' | 'COMPLETED' | 'CANCELLED', required
    - `terms_summary` string, nullable: Detail only.
    - `created_at` string, date-time
    - `completed_at` string, date-time, nullable

## 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)