Data dictionary and schema for the property listings responses.
This page contains a data dictionary and a description of all response fields for our property sale listings and rental listings endpoints (/listings
).
Property Listings Response Fields
The following response fields will be returned as part of both sale and rental listing records:
Response Field | Description | Example Value |
---|---|---|
| Property Id A unique RentCast property identifier |
|
| Formatted Address The full property address, in the format |
|
| Address Line 1 The first line of the property street address |
|
| Address Line 2 The second line of the property street address, typically containing the unit or apartment identifier |
|
| Address City The city of the property address |
|
| Address State The state of the property address, as a 2-character abbreviation |
|
| Address Zip Code The 5-digit zip code of the property address |
|
| County The county in which the property is located |
|
| Latitude The latitude of the property's geographical location |
|
| Longitude The longitude of the property's geographical location |
|
| Property Type The type of the property. See explanation of property types for possible values |
|
| Number of Bedrooms The number of bedrooms in the property, with a value of "0" indicating a studio layout |
|
| Number of Bathrooms The number of bathrooms in the property |
|
| Living Area (Sq.Ft.) The total indoor living area of the property, in square feet |
|
| Lot Area (Sq.Ft.) The total lot size of the property parcel, in square feet |
|
| Year Built The year in which the property was constructed |
|
| HOA Details Information about the property's homeowner's association (HOA) |
|
| HOA Fee Amount (Monthly) The total monthly HOA fee or assessment amount |
|
| Listing Status The current property listing status. See explanation of listing statuses for possible values |
|
| Listed Price or Rent The listed price or rent of the property listing |
|
| Listing Type The type of the property listing. See explanation of listing types for possible values |
|
| Date Listed The date the property was most recently listed for sale or rent, in ISO 8601 format |
|
| Date Delisted The date the property listing was most recently removed or delisted, in ISO 8601 format |
|
| Date Created The date the property listing was first seen and created, in ISO 8601 format |
|
| Date Last Seen The date the property listing was most recently seen as active, in ISO 8601 format |
|
| Days on Market The number of days the property listing has been active |
|
| MLS Name The MLS name of the property listing, if listed on the Multiple Listing Service (MLS) |
|
| MLS Number The MLS number or unique identifier of the property listing, if listed on the Multiple Listing Service (MLS) |
|
| Listing Agent Details Information about the listing agent of the property, typically representing the property seller |
|
| Listing Agent - Name The name of the listing agent, typically in the format |
|
| Listing Agent - Phone Number The phone number of the listing agent, typically consisting of 10 digits, including the area code |
|
| Listing Agent - Email Address The email address of the listing agent | |
| Listing Agent - Website URL The website URL of the listing agent |
|
| Listing Office Details Information about the listing office or broker of the property, typically representing the property seller |
|
| Listing Office - Name The name of the listing office or broker |
|
| Listing Office - Phone Number The phone number of the listing office or broker, typically consisting of 10 digits, including the area code |
|
| Listing Office - Email Address The email address of the listing office or broker | |
| Listing Office - Website URL The website URL of the listing office or broker |
|
| Builder Details Information about the builder of the property. This field will only be present for new construction listings |
|
| Builder - Name The name of the property builder |
|
| Builder - Development Name The name of the development or new construction community in which the property is located |
|
| Builder - Phone Number The phone number of the property builder, typically consisting of 10 digits, including the area code |
|
| Builder - Website URL The website URL of the property builder |
|
| Listing History A list of historical listing entries for this property, with JSON keys indicating the listing date, in the format |
|
| Listing History Entry A single historical listing entry, with listing information specific to a past listing date |
|
| Listing History Entry - Event Type The type of the historical listing entry, with possible values of "Sale Listing" for sale listings, or "Rental Listing" for rental listings |
|
| Listing History Entry - Listed Price or Rent The last known listed price or rent of the property listing |
|
| Listing History Entry - Listing Type The type of the property listing. See explanation of listing types for possible values |
|
| Listing History Entry - Date Listed The date the property was listed for sale or rent, in ISO 8601 format |
|
| Listing History Entry - Date Delisted The date the property listing was removed or delisted, in ISO 8601 format |
|
| Listing History Entry - Days on Market The number of days the property listing has been active |
|
Listing Status Field Values
The following is a list of possible values of the listing status
response field:
Listing Status | Description |
---|---|
Active | Indicates an active listing, which is currently listed on the market. Returned listing fields will reflect the current listing attributes, such as price, listed date, days on the market, etc. |
Inactive | Indicates an inactive listing, which is not currently listed on the market. Returned listing fields will reflect the last known listing attributes, such as the last known price, listed date, days on the market, etc. |
Listing Type Field Values
The following is a list of possible values of the listing listingType
response field:
Listing Type | Description |
---|---|
Standard | A standard or regular listing, which is not classified as another listing type |
New Construction | A listing for a recently constructed property, typically built within the last 12 months |
Foreclosure | A sale listing that is part of a foreclosure process, typically being sold by a lending institution that foreclosed on the property |
Short Sale | A sale listing that is part of a short sale process, typically being sold by a financially distressed property owner |