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 |
|---|---|---|
id | Property Id Data type: String A unique RentCast property identifier | "3821-Hargis-St,-Austin,-TX-78723" |
formattedAddress | Formatted Address Data type: String The full property address, in the format Street, Unit, City, State Zip | "3821 Hargis St, Austin, TX 78723" |
addressLine1 | Address Line 1 Data type: String The first line of the property street address | "3821 Hargis St" |
addressLine2 | Address Line 2 Data type: String The second line of the property street address, typically containing the unit or apartment identifier | "Apt 12" |
city | Address City Data type: String The city of the property address | "Austin" |
state | Address State Data type: String The state of the property address, as a 2-character abbreviation | "TX" |
zipCode | Address Zip Code Data type: String The 5-digit zip code of the property address | "78723" |
county | County Data type: String The county in which the property is located | "Travis" |
latitude | Latitude Data type: Number The latitude of the property's geographical location | 30.290643 |
longitude | Longitude Data type: Number The longitude of the property's geographical location | -97.701547 |
propertyType | Property Type Data type: String (Enum) The type of the property. See explanation of property types for possible values | "Single Family" |
bedrooms | Number of Bedrooms Data type: Number The number of bedrooms in the property, with a value of "0" indicating a studio layout | 4 |
bathrooms | Number of Bathrooms Data type: Number The number of bathrooms in the property | 2.5 |
squareFootage | Living Area (Sq.Ft.) Data type: Number The total indoor living area of the property, in square feet | 2345 |
lotSize | Lot Area (Sq.Ft.) Data type: Number The total lot size of the property parcel, in square feet | 3284 |
yearBuilt | Year Built Data type: Number The year in which the property was constructed | 2008 |
hoa | HOA Details Data type: Object Information about the property's homeowner's association (HOA) | { ... } |
hoa.fee | HOA Fee Amount (Monthly) Data type: Number The total monthly HOA fee or assessment amount | 65 |
status | Listing Status Data type: String (Enum) The current property listing status. See explanation of listing statuses for possible values | "Active" |
price | Listed Price or Rent Data type: Number The listed price or rent of the property listing | 899000 |
listingType | Listing Type Data type: String (Enum) The type of the property listing. See explanation of listing types for possible values | "Standard" |
listedDate | Date Listed Data type: Date The date the property was most recently listed for sale or rent, in ISO 8601 format | "2024-06-24T00:00:00.000Z" |
removedDate | Date Delisted Data type: Date The date the property listing was most recently removed or delisted, in ISO 8601 format | "2024-10-01T00:00:00.000Z" |
createdDate | Date Created Data type: Date The date the property listing was first seen and created, in ISO 8601 format | "2021-06-25T00:00:00.000Z" |
lastSeenDate | Date Last Seen Data type: Date The date the property listing was most recently seen as active, in ISO 8601 format | "2024-09-30T13:11:47.157Z" |
daysOnMarket | Days on Market Data type: Number The number of days the property listing has been active | 99 |
mlsName | MLS Name Data type: String The MLS name of the property listing, if listed on the Multiple Listing Service (MLS) | "UnlockMLS" |
mlsNumber | MLS Number Data type: String The MLS number or unique identifier of the property listing, if listed on the Multiple Listing Service (MLS) | "5519228" |
listingAgent | Listing Agent Details Data type: Object Information about the listing agent of the property, typically representing the property seller | { ... } |
listingAgent.name | Listing Agent - Name Data type: String The name of the listing agent, typically in the format First Last | "Jennifer Welch" |
listingAgent.phone | Listing Agent - Phone Number Data type: String The phone number of the listing agent, typically consisting of 10 digits, including the area code | "5124313110" |
listingAgent.email | Listing Agent - Email Address Data type: String The email address of the listing agent | "[email protected]" |
listingAgent.website | Listing Agent - Website URL Data type: String The website URL of the listing agent | "https://example.com" |
listingOffice | Listing Office Details Data type: Object Information about the listing office or broker of the property, typically representing the property seller | { ... } |
listingOffice.name | Listing Office - Name Data type: String The name of the listing office or broker | "Gottesman Residential RE" |
listingOffice.phone | Listing Office - Phone Number Data type: String The phone number of the listing office or broker, typically consisting of 10 digits, including the area code | "5124512422" |
listingOffice.email | Listing Office - Email Address Data type: String The email address of the listing office or broker | "[email protected]" |
listingOffice.website | Listing Office - Website URL Data type: String The website URL of the listing office or broker | "https://example.com" |
builder | Builder Details Data type: Object Information about the builder of the property. This field will only be present for new construction listings | { ... } |
builder.name | Builder - Name Data type: String The name of the property builder | "Pulte Homes" |
builder.development | Builder - Development Name Data type: String The name of the development or new construction community in which the property is located | "Hampton Lakes at River Hall" |
builder.phone | Builder - Phone Number Data type: String The phone number of the property builder, typically consisting of 10 digits, including the area code | "2392300326" |
builder.website | Builder - Website URL Data type: String The website URL of the property builder | "https://example.com" |
history | Listing History Data type: Object A list of historical listing entries for this property, with JSON keys indicating the listing date, in the format YYYY-MM-DD | { "2024-06-24": { ... } } |
history[YYYY-MM-DD] | Listing History Entry Data type: Object A single historical listing entry, with listing information specific to a past listing date | { ... } |
history[YYYY-MM-DD] .event | Listing History Entry - Event Type Data type: String (Enum) The type of the historical listing entry, with possible values of "Sale Listing" for sale listings, or "Rental Listing" for rental listings | "Sale Listing" |
history[YYYY-MM-DD] .price | Listing History Entry - Listed Price or Rent Data type: Number The last known listed price or rent of the property listing | 899000 |
history[YYYY-MM-DD] .listingType | Listing History Entry - Listing Type Data type: String (Enum) The type of the property listing. See explanation of listing types for possible values | "Standard" |
history[YYYY-MM-DD] .listedDate | Listing History Entry - Date Listed Data type: Date The date the property was listed for sale or rent, in ISO 8601 format | "2024-06-24T00:00:00.000Z" |
history[YYYY-MM-DD] .removedDate | Listing History Entry - Date Delisted Data type: Date The date the property listing was removed or delisted, in ISO 8601 format | "2024-10-01T00:00:00.000Z" |
history[YYYY-MM-DD] .daysOnMarket | Listing History Entry - Days on Market Data type: Number The number of days the property listing has been active | 99 |
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 |