List sales / lease / exchanges

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

# Aircraft listings only
curl "$base_url/public/v1/sales-lease-exchange?listing_type=aircraft&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Engine listings only — optionally narrowed by engine_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=engine&engine_model=CFM56-5B&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# APU listings only — optionally narrowed by apu_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=apu&apu_model=APS3200&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Free-text search across title / description / msn
curl "$base_url/public/v1/sales-lease-exchange?search=CFM56&country=US&per_page=50" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

import requests

# All listings
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"page": 1, "per_page": 50},
)

# Engines only, case-insensitive vocab name filter
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"listing_type": "engine", "engine_model": "cfm56-5b"},
)
resp.raise_for_status()
for listing in resp.json()["items"]:
    print(listing["id"], listing["price_usd"])

GET

public

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"

# Aircraft listings only
curl "$base_url/public/v1/sales-lease-exchange?listing_type=aircraft&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Engine listings only — optionally narrowed by engine_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=engine&engine_model=CFM56-5B&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# APU listings only — optionally narrowed by apu_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=apu&apu_model=APS3200&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Free-text search across title / description / msn
curl "$base_url/public/v1/sales-lease-exchange?search=CFM56&country=US&per_page=50" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

import requests

# All listings
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"page": 1, "per_page": 50},
)

# Engines only, case-insensitive vocab name filter
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"listing_type": "engine", "engine_model": "cfm56-5b"},
)
resp.raise_for_status()
for listing in resp.json()["items"]:
    print(listing["id"], listing["price_usd"])

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

string

required

Bearer tdao_live_…

string

required

Your organization’s UUID.

Query parameters

Filtering

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.

string

Filter by aircraft-type name (e.g. A320-200). Case-insensitive. Same DX as the create endpoint no UUID lookup.

string

Filter by engine-model name (e.g. CFM56-5B). Case-insensitive.

string

Filter by APU model name (e.g. APS3200). Case-insensitive.

string

Substring, case-insensitive.

string

Free-text search across title / description / msn.

Pagination

integer

default:"1"

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"

# Aircraft listings only
curl "$base_url/public/v1/sales-lease-exchange?listing_type=aircraft&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Engine listings only — optionally narrowed by engine_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=engine&engine_model=CFM56-5B&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# APU listings only — optionally narrowed by apu_model name
curl "$base_url/public/v1/sales-lease-exchange?listing_type=apu&apu_model=APS3200&page=1&per_page=20" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

# Free-text search across title / description / msn
curl "$base_url/public/v1/sales-lease-exchange?search=CFM56&country=US&per_page=50" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

import requests

# All listings
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"page": 1, "per_page": 50},
)

# Engines only, case-insensitive vocab name filter
resp = requests.get(
    f"{base_url}/public/v1/sales-lease-exchange",
    headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
    params={"listing_type": "engine", "engine_model": "cfm56-5b"},
)
resp.raise_for_status()
for listing in resp.json()["items"]:
    print(listing["id"], listing["price_usd"])

Concepts

Teardowns

Sales / Lease / Exchange

Headers

Query parameters

Filtering

Response

See also

​Headers

​Query parameters

​Filtering

​Pagination

​Response

​See also

Headers

Query parameters

Filtering

Pagination

Response

See also