Skip to main content
GET
/
public
/
v1
/
sales-lease-exchange
# Every active sales / lease / exchange listing in the org
curl "$base_url/public/v1/sales-lease-exchange?page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

Documentation Index

Fetch the complete documentation index at: https://teardowns.aero/docs/llms.txt

Use this file to discover all available pages before exploring further.

Always org-scoped returns only listings owned by your organization.
This endpoint returns only active sales / lease / exchange listings. By design. Listings your team has moved to sold, under_offer, leased, exchanged, suspended, archived, draft, or pending_review are not included in the list response and there is no query parameter to opt in. If you need to read a listing in any other status, fetch it directly by id via GET /public/v1/sales-lease-exchange/{listing_id} — the detail endpoint surfaces every status.

Headers

Authorization
string
required
Bearer tdao_live_…
X-Organization-Id
string
required
Your organization’s UUID.

Query parameters

Filtering

listing_type
string
One of aircraft, engine, or apu. Sending parts or landing_gear returns 422. Legacy rows of those types remain readable via the detail endpoint.
aircraft_type
string
Filter by aircraft-type name (e.g. A320-200). Case-insensitive. Same DX as the create endpoint no UUID lookup.
engine_model
string
Filter by engine-model name (e.g. CFM56-5B). Case-insensitive.
apu_model
string
Filter by APU model name (e.g. APS3200). Case-insensitive.
condition
string
country
string
Substring, case-insensitive.
Free-text search across title / description / msn.

Pagination

page
integer
default:"1"
per_page
integer
default:"20"
Minimum 1, maximum 100.

Response

200 OK. Paginated envelope:
{
  "items": [ /* ListingBrowseResponse[] */ ],
  "total": 12,
  "page": 1,
  "per_page": 20,
  "pages": 1
}
Each item carries the headline fields (id, listing_type, title, msn, condition, price, country, status, the vocab object, etc.) plus the seller_org summary used in the marketplace browse table.
# Every active sales / lease / exchange listing in the org
curl "$base_url/public/v1/sales-lease-exchange?page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

See also