---
title: "Accept a proposal you received"
method: POST
path: "/api/v1/proposals/{id}/accept"
---

# Accept a proposal you received

`POST /api/v1/proposals/{id}/accept`

## Request

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

Scope: trade. Creates a Handshake in PENDING_PAYMENT and returns machine-readable payment instructions for the Handshake fee (amount and chain are in the response).

## Path parameters

- `id` string, uuid, required

## Response `201`

handshake_id + payment instructions.

- object
  - `handshake_id` string, uuid, required
  - `status` string
  - `payment` Payment, required
    - `required` boolean
    - `state` 'covered' | 'payable' | 'settled', required
    - `covered_by` 'launch_promo' | 'membership' | 'partner_membership' | 'free_handshake'
    - `settle` object
      - `method` string
      - `path` string
    - `amount` string
    - `note` string

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