Alpha Only: This service is subject to change
This service is a work in progress. It is currently subject to change or removal without notice.

Listings: Rules

Rulesets can be defined for each property type in an MLS that govern how listing data is entered into the system. Examples of listing rules are 'required fields' and 'conditionally required fields'.

  1. Supported Roles
  2. Available Services
    1. Individual Listing Rule
    2. Listing Rules for a Property Type
    3. Listing Rules for an Action
    4. Listing Rules for a Field
  3. Listings: Rules Description
  4. Expansions
  5. API Explorer

Supported Roles

Role Reads Writes Notes
IDX No No
Public No No
VOW No No
Portal No No
Private Yes Yes Special permission is required to modify rules for an MLS.
More information about roles may be found here.

Available Services

Individual Listing Rule

URI: /<API Version>/listings/rules/<Rule.Id>

HTTP Method Description Conditional Notes
GET Returns HTTP 405 (Method Not Allowed) No Not implemented
POST Returns HTTP 405 (Method Not Allowed) No Not implemented
PUT Updates an individual rule No
DELETE Deletes a rule No

PUT Request

Request body:
{
   "D":{
      "Action": "SET_REQUIRED"
   }
}

PUT Response

The standard success/fail response with additional error information is returned.

DELETE Request

Parameters:
  • None

DELETE Response

The standard success/fail response is returned.

Listing Rules for a Property Type

URI: /<API Version>/listings/rules/propertytypes/<PropertyType.MlsCode>

HTTP Method Description Conditional Notes
GET Returns all rules for a property type No
POST Adds a new rule to a property type No
PUT Replaces all rules for a property type No
DELETE Returns HTTP 405 (Method Not Allowed) No Not implemented

GET Request

Parameters:
Parameter Required Notes
Pagination No _limit can be set to all to return all records.

GET Response

{
        "D": {
                "Success": true,
                "Results": [{
                                "Id": 1,
                                "ResourceUri": "/vX/listings/rules/1",
                                "Group": null,
                                "Domain": null,
                                "Field": "BathsTotal",
                                "Action": "SET_REQUIRED",
                                "Expression": "StandardStatus = 'Active'",
                                "ModificationTimestamp": "2012-03-06T16:28:42Z",
                                "CreatedTimestamp": "2012-03-06T16:28:42Z"
                        },
                        {
                                "Id": 2,
                                "ResourceUri": "/vX/listings/rules/2",
                                "Group": null,
                                "Domain": null,
                                "Field": "ListPrice",
                                "Action": "SET_REQUIRED",
                                "Expression": null,
                                "ModificationTimestamp": "2012-03-06T16:29:21Z",
                                "CreatedTimestamp": "2012-03-06T16:29:21Z"
                        }
                ]
        }
}

POST Request

Request body:
{
   "D": {
     "Group": null,
     "Domain": null,
     "Field": "BathsTotal",
     "Action": "SET_REQUIRED",
     "Expression": "StandardStatus = 'Active'"
   }
}

POST Response

The standard success/fail response with additional error information is returned.

PUT Request

Request body:
{
   "D": [
      {
         "Group": null,
         "Domain": null,
         "Field": "BathsTotal",
         "Action": "SET_REQUIRED",
         "Expression": "StandardStatus = 'Active'"
      },
      {
         "Group": null,
         "Domain": null,
         "Field": "ListPrice",
         "Action": "SET_REQUIRED",
         "Expression": null
      }
   ]
   
}

PUT Response

The standard success/fail response with additional error information is returned.

Listing Rules for an Action

URI: /<API Version>/listings/rules/propertytypes/<PropertyType.MlsCode>/actions/<Rule.Action>

HTTP Method Description Conditional Notes
GET Returns all rules for a specific action and property type No
POST Returns HTTP 405 (Method Not Allowed) No Not implemented
PUT Returns HTTP 405 (Method Not Allowed) No Not implemented
DELETE Returns HTTP 405 (Method Not Allowed) No Not implemented

GET Request

Parameters:
Parameter Required Notes
Pagination No _limit can be set to all to return all records.

GET Response

See the GET request section for for the Listing Rules for a Property Type service.

Listing Rules for a Field

URI: /<API Version>/listings/rules/propertytypes/<PropertyType.MlsCode>/fields/<Rule.FieldName>

HTTP Method Description Conditional Notes
GET Returns all rules for a specific field and property type No
POST Returns HTTP 405 (Method Not Allowed) No Not implemented
PUT Returns HTTP 405 (Method Not Allowed) No Not implemented
DELETE Returns HTTP 405 (Method Not Allowed) No Not implemented

GET Request

Parameters:
Parameter Required Notes
Pagination No _limit can be set to all to return all records.

GET Response

See the GET request section for for the Listing Rules for a Property Type service.

Listing: Rules Description

Attribute Data Type Writeable Required Description
Id Character No No The unique id for the rule.
ResourceUri Character No No The URI to the individual rule.
Domain Character Creation only Yes May be one of the following: StandardFields or CustomFields.
Group Character Creation only If Domain is CustomFields The custom fields group for the field.
FieldName Character Creation only Yes The standard or custom field name the Action applies to.
Action Character Yes Yes May be one of the following: SET_REQUIRED.
Expression Character Yes No YTBD
ModificationTimestamp Timestamp The date and time when the history event occurred.
CreatedTimestamp Timestamp The date and time when the history event occurred.

Actions

Name Expression example Description
SET_REQUIRED null The FieldName must have a value.

Expansions

None.

API Explorer

The API Explorer does not currently support this service.