SearchPropertiesRequest

Request model for POST /api/v1/properties/search. Supports polygon/multi-polygon geometry queries and point+radius queries.

  • Pagination cursor from previous response.

  • Optional filters to apply alongside spatial query.

    Properties: 3
  • Center point for radius search. Mutually exclusive with within.

    Properties: 2
  • Number of results per page (1-500, default 50).

  • Search radius in meters. Required with near.

  • Sort order: "distance" or "updated" (default). "distance" requires near or sort_origin.

  • Explicit origin point for distance calculation. Required for sort=distance with within.

    Properties: 2
  • GeoJSON geometry object (Polygon or MultiPolygon only). Coordinates follow GeoJSON standard: [longitude, latitude]. Mutually exclusive with near.