Select a parcel for a sale

POST

/v1/trades/{sellTradeId}/parcels

Allocates units of one buy trade to a sell trade. The buy trade must be one the sale's parcel list
offers, with enough units available. Needs Manual Parcel Selection on the plan of the account that
owns the portfolio.

Access

OAuth scope: transactions:write

Available on: every plan, including free trials

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params

application/json-patch+json

Example

{
    "buyTradeId": 0,
    "quantitySold": 0
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/trades//parcels' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json-patch+json' \
--data '{
    "buyTradeId": 0,
    "quantitySold": 0
}'

Responses

🟢200OK

application/json

Success

Body

Example

"497f6eca-6276-4993-bfeb-53cbbbba6f08"

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

Modified at 2026-09-29 03:34:01

Get the parcels for a sale

Change a parcel selection