---
title: "Changes to Retrieves residential listings matching the specified criteria."
method: POST
path: "/v1/listings/residential/_search"
---

# Changes to Retrieves residential listings matching the specified criteria.

`POST /v1/listings/residential/_search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 18 revisions.

- **2026-05-08** `7130302fb268`: 6 breaking, 6 warning, 6 info

## Changes

- **2026-05-08** `7130302fb268`: 6 breaking, 6 warning, 6 info
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: application/json)
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: text/json)
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: text/html)
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: application/xml)
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: text/xml)
  - removed the enum value `Proximity` of the request property `sort/sortKey` (media type: application/x-www-form-urlencoded)
  - removed the request property `sort/proximityTo` (media type: application/json)
  - removed the request property `sort/proximityTo` (media type: text/json)
  - removed the request property `sort/proximityTo` (media type: text/html)
  - removed the request property `sort/proximityTo` (media type: application/xml)
  - removed the request property `sort/proximityTo` (media type: text/xml)
  - removed the request property `sort/proximityTo` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `aggregations` (media type: application/json)
  - added the new optional request property `aggregations` (media type: text/json)
  - added the new optional request property `aggregations` (media type: text/html)
  - added the new optional request property `aggregations` (media type: application/xml)
  - added the new optional request property `aggregations` (media type: text/xml)
  - added the new optional request property `aggregations` (media type: application/x-www-form-urlencoded)

---

[Operation](https://skmtc.dev/domain/apis/domain-public-api/docs/v1/listings/residential/_search/post.md) - [API](https://skmtc.dev/domain/apis/domain-public-api.md) - [Page](https://skmtc.dev/domain/apis/domain-public-api/changes/v1/listings/residential/_search/post)