Skip to content
English - United Kingdom
  • There are no suggestions because the search field is empty.

How does the legacy V3 Sales API work?

The V3 Sales API is a legacy read-only tier for accessing sales instructions, offers, buyers, and vendors. New integrations should use the V4 Advertising API instead. All endpoints are at https://live-api.letmc.com/v3/sales/.

⚠️ Legacy API — existing integrations only. The V3 Sales API is read-only and will not receive new features. For new integrations, use the V4 Advertising API, which provides modern patterns, advanced filtering, and cross-branch queries.

Key limitations

  • Read-only — data retrieval only, no creation or update capabilities
  • Pagination uses query parameters rather than URL path parameters
  • Contact queries require a specific branch ID — cross-branch queries require multiple API calls
  • No advanced filtering or search functionality

Sales instructions

  • Get sales instruction: GET /v3/sales/{shortName}/salesinstructions/{salesInstructionID} Returns comprehensive data including property information, pricing, sales progress, vendor links, offer management, and viewing configuration.

Sales offers

  • Get sales offer: GET /v3/sales/{shortName}/offers/{offerID} Returns offer amount, status, buyer information, sales instruction link, and financial terms.

Buyer contacts

  • Get active buyers (legacy pagination): GET /contacts/getbuyers Parameters: branchID, offset, count. Maximum 1,000 per request. Archived buyers are excluded automatically.
  • Get specific buyer: GET /contacts/getbuyers/{buyerID} Returns contact details, property requirements, search preferences, and marketing consent status.

Vendor contacts

  • Get active vendors (legacy pagination): GET /contacts/getvendors Parameters: branchID, offset, count. Archived vendors are excluded automatically.
  • Get specific vendor: GET /contacts/getvendors/{vendorID} Returns contact details, associated sales instructions, sales history, and communication preferences.

Migrating to V4 Advertising

The V4 Advertising API offers: modern URL path pagination, advanced filtering and search, cross-branch queries, improved contact management, and active feature development.

Test with Swagger: Select "V3.Sales" from the tier dropdown. Specify valid branch IDs when querying buyer and vendor contacts.