Get the parcels for a sale

GET

/v1/trades/{sellTradeId}/parcels

Returns the manual parcel selection panel for a sell trade: the buy parcels still available to it,
the parcels already selected, and the locked financial year if one settles the sale.
canSelectParcels and selectionLockReason say whether the caller may change the
selection: read_only, owner_plan, plan_not_eligible or
subscription_inactive.

Access

OAuth scope: transactions:read

Available on: every plan, including free trials

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Success

Body

Example

{
    "lockedFinancialYear": 0,
    "available": [
        {
            "tradeId": 0,
            "tradeDate": "2019-08-24T14:15:22.123Z",
            "originalQuantity": 0,
            "originalPrice": 0,
            "availableQuantity": 0,
            "adjustedQuantity": 0,
            "adjustedPrice": 0
        }
    ],
    "allocated": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "quantitySold": 0,
            "soldTradeId": 0,
            "buyTradeId": 0
        }
    ],
    "canSelectParcels": true,
    "selectionLockReason": "string"
}

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429

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

Commit an import's staged trades

Select a parcel for a sale