Fetch all published sales (public)

Independent developers can read all published sales and parse metadata across regions. This is read-only.

HTTP

Endpoint: GET /v1/sales

Auth: none (public)

Status: coming next (this page defines the contract)

Response shape

Each sale includes region and listing slugs so you can build stable URLs and analytics keys.

{
  "ok": true,
  "sales": [
    {
      "id": "uuid",
      "title": "string",
      "city": "string",
      "state": "string",
      "start_date": "YYYY-MM-DD",
      "end_date": "YYYY-MM-DD",
      "region_slug": "atlanta-ga",
      "listing_slug": "smith-family-estate-2026",
      "published_at": "ISO timestamp"
    }
  ]
}

Node example

const res = await fetch("https://api.openestatesales.com/v1/sales");
const json = await res.json();
console.log(json.sales.length);