Search Sales

GET /api/v1/sales/search

Search recorded property sales (deed transfers) from county assessment-roll sale data, filterable by county, sale-date range, price range, and use code. Each row carries the deed book/page, instrument number, deed and qualification codes, and grantor/grantee. To get the sale history of one specific parcel, use GET /api/v1/parcels/{id}/sales.

Authentication

curl -H "X-API-Key: fpapi_test_..." \
  "https://api.floridapropertyapi.com/v1/sales/search?county=hillsborough&from=2021-01-01&min_price=250000&limit=10"

Query Parameters

Name	Type	Required	Default	Description
county	string | string[]	no	—	County slug(s). Repeatable or CSV.
from	date (YYYY-MM-DD)	no	—	Only sales on/after this date.
to	date (YYYY-MM-DD)	no	—	Only sales on/before this date.
min_price	number	no	—	Minimum sale price.
max_price	number	no	—	Maximum sale price.
use_code	string | string[]	no	—	Property use code(s). Repeatable or CSV.
sort	enum (date_newest, date_oldest, price_desc, price_asc)	no	—	Result ordering.
limit	integer 1-500	no	25	Page size.
offset	integer ≥ 0	no	0	Pagination offset.

Response (200)

List envelope { data: SaleHit[], pagination, meta }.

{
  "data": [
    {
      "id": "sale_8fc21a09",
      "county_slug": "hillsborough",
      "county_parcel_id": "192829-5040-001000-0010",
      "sale_date": "2021-04-15",
      "sale_price": 460000,
      "book": "24891",
      "page": "1432",
      "instrument_number": "2021145238",
      "deed_code": "WD",
      "qualification_code": "Q",
      "grantor": "JONES ROBERT L",
      "grantee": "SMITH JOHN A & MARY B"
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "total": 1, "has_more": false },
  "meta": { "request_id": "req_1234567890abcdef12345", "dataset_status": "live" }
}

deed_code and qualification_code are the raw county/FDOR codes (e.g. WD warranty deed, Q qualified sale).

Error Responses

Status	Code	Cause
400	bad_request	Invalid query parameters.
401	unauthorized	Missing or invalid API key.
429	rate_limited	Rate limit exceeded.
500	internal_error	Server error — retry with backoff.