In many cases it can be useful to get metadata about the properties available in a feed. For example, a list of cities or neighborhoods found in the feed can be used to build a search form autocomplete component, or to generate listing pages for hyper-local areas.

In SimplyRETS, this metadata is available by making an OPTIONS request to the /properties endpoint. The API will include this higher-level information about the feed:

  • status: A list of statuses found in the feed.
  • cities: A list of cities found in the feed.
  • counties: A list of counties found in the feed.
  • features: A list of interiorFeatures found in the feed.
  • neighborhoods: A list of neighborhoods found in the feed.
  • areaMinor: A list of MLS area minors found in the feed.
  • type: A list of property types found in the feed.
  • lastUpdate: Timestamp of the last successful sync.
  • expires: Expiration date of this metadata.

The best practice for using this metadata is to store the information in your database, and refresh it at least once a day. The OPTIONS request is not intended to be used on page-load like GET /properties, especially with large feeds.

Example request and response

Here is what making an OPTIONS request looks like with the program curl:

Example request

$ curl -XOPTIONS -u key:secret ""

This makes an OPTIONS request to the /properties endpoint. The library you’re using the make API requests from your program will have a way to set the HTTP.

Note: If your app has multiple feeds, you need use the vendor parameter.

Example response

Here is an example of what the API response will contain:

  "expires": "2020-01-02T00:00:00.00000Z",
  "lastUpdate": "2020-01-01T00:00:00.00000Z",
  "fields": {
    "status": [
    "cities": [
      "Leage City"
    "counties": [
    "features": [
      "Air Filter System",
      "Ethernet Wiring",
    "neighborhoods": [
    "areaMinor": [
    "type": [

Now, try it out on your own feed! As always, if you have any questions or issues, send us a message and we’ll be happy to help.