Property Listings Schema

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 StatusDescription
ActiveIndicates 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.
InactiveIndicates 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 TypeDescription
StandardA standard or regular listing, which is not classified as another listing type
New ConstructionA 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 SaleA sale listing that is part of a short sale process, typically being sold by a financially distressed property owner