Property Data Schema

Data dictionary and schema for the property data responses.

This page contains a data dictionary and a description of all response fields for our property data endpoints (/properties).

 

Property Records Response Fields

The following response fields will be returned as part of property records:

Response Field

Description

Example Value

id

Property Id
Data type: String

A unique RentCast property identifier

"5500-Grand-Lake-Dr,-San-Antonio,-TX-78244"

formattedAddress

Formatted Address
Data type: String

The full property address, in the format Street, Unit, City, State Zip

"5500 Grand Lake Dr, San Antonio, TX 78244"

addressLine1

Address Line 1
Data type: String

The first line of the property street address

"5500 Grand Lake Dr"

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

"San Antonio"

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

"78244"

county

County
Data type: String

The county in which the property is located

"Bexar"

latitude

Latitude
Data type: Number

The latitude of the property's geographical location

29.476011

longitude

Longitude
Data type: Number

The longitude of the property's geographical location

-98.351454

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

3

bathrooms

Number of Bathrooms
Data type: Number

The number of bathrooms in the property

2

squareFootage

Living Area (Sq.Ft.)
Data type: Number

The total indoor living area of the property, in square feet

1878

lotSize

Lot Area (Sq.Ft.)
Data type: Number

The total lot size of the property parcel, in square feet

8843

yearBuilt

Year Built
Data type: Number

The year in which the property was constructed

1973

assessorID

Assessor Id
Data type: String

The county assessor identifier or assessor parcel number (APN) of the property

"05076-103-0500"

legalDescription

Legal Description
Data type: String

The legal description of the property, as provided by county records

"CB 5076A BLK 3 LOT 50"

subdivision

Subdivision
Data type: String

The subdivision identifier of the property, as provided by county records

"CONV A/S CODE"

zoning

Zoning Code
Data type: String

The zoning code or description of the property, as provided by county records

"RH"

lastSaleDate

Last Sale Date
Data type: Date

The date the property was last sold, in ISO 8601 format

"2017-10-19T00:00:00.000Z"

lastSalePrice

Last Sale Price
Data type: Number

The last known sale price of the property

185000

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

175

features

Property Features
Data type: Object

A list of property features and characteristics

{ ... }

features
.architectureType

Feature - Architecture Type
Data type: String

The architecture type of the property, as provided by county records. See list of architecture types for possible values

"Contemporary"

features.cooling

Feature - Cooling
Data type: Boolean

A field indicating whether or not the property has a cooling system

true

features
.coolingType

Feature - Cooling Type
Data type: String

The type of the cooling system installed at the property, as provided by county records. See list of cooling types for possible values

"Central"

features
.exteriorType

Feature - Exterior Type
Data type: String

The exterior type of the property, as provided by county records. See list of exterior types for possible values

"Wood"

features.fireplace

Feature - Fireplace
Data type: Boolean

A field indicating whether or not the property has a fireplace

true

features
.fireplaceType

Feature - Fireplace Type
Data type: String

The type of fireplace installed at the property, as provided by county records. See list of fireplace types for possible values

"Masonry"

features.floorCount

Feature - Floor Count
Data type: Number

The number of above-ground floors or stories in the property

1

features
.foundationType

Feature - Foundation Type
Data type: String

The foundation type of the property, as provided by county records. See list of foundation types for possible values

"Slab / Mat / Raft"

features.garage

Feature - Garage
Data type: Boolean

A field indicating whether or not the property has a garage

true

features
.garageSpaces

Feature - Garage Spaces
Data type: Number

The number of garage spaces in the property

2

features.garageType

Feature - Garage Type
Data type: String

The garage type of the property, as provided by county records. See list of garage types for possible values

"Garage"

features.heating

Feature - Heating
Data type: Boolean

A field indicating whether or not the property has a heating system

true

features
.heatingType

Feature - Heating Type
Data type: String

The type of the heating system installed at the property, as provided by county records. See list of heating types for possible values

"Forced Air"

features.pool

Feature - Pool
Data type: Boolean

A field indicating whether or not the property has a pool

true

features.poolType

Feature - Pool Type
Data type: String

The pool type of the property, as provided by county records. See list of pool types for possible values

"Concrete"

features.roofType

Feature - Roof Type
Data type: String

The roof type of the property, as provided by county records. See list of roof types for possible values

"Asphalt"

features.roomCount

Feature - Room Count
Data type: Number

The number of interior rooms in the property, including bedrooms, living rooms, dens, kitchens and dining rooms

5

features.unitCount

Feature - Unit Count
Data type: Number

The number of individual units in the property, if it is a multi-dwelling building

1

features.viewType

Feature - View Type
Data type: String

The type of view of the property, as provided by county records. See list of view types for possible values

"City"

taxAssessments

Tax Assessments
Data type: Object

A list of tax assessments for this property, with JSON keys indicating the tax year, in the format YYYY

{ "2023": { ... } }

taxAssessments[YYYY]

Tax Assessment Entry
Data type: Object

A single tax assessment entry, with data for a specific tax year

{ ... }

taxAssessments[YYYY]
.year

Tax Assessment Entry - Year
Data type: Number

The tax assessment year

2023

taxAssessments[YYYY]
.value

Tax Assessment Entry - Total Assessment
Data type: Number

The total assessed value of the property, including land and improvements

225790

taxAssessments[YYYY]
.land

Tax Assessment Entry - Land Assessment
Data type: Number

The assessed value of the land

59380

taxAssessments[YYYY]
.improvements

Tax Assessment Entry - Improvements Assessment
Data type: Number

The assessed value of the building and improvements

166410

propertyTaxes

Property Taxes
Data type: Object

A list of property taxes for this property, with JSON keys indicating the tax year, in the format YYYY

{ "2023": { ... } }

propertyTaxes[YYYY]

Property Tax Entry
Data type: Object

A single property tax entry, with data for a specific tax year

{ ... }

propertyTaxes[YYYY]
.year

Property Tax Entry - Year
Data type: Number

The property tax year

2023

propertyTaxes[YYYY]
.total

Property Tax Entry - Total Tax
Data type: Number

The total annual property tax amount

4201

history

Property History
Data type: Object

A list of sale transactions for this property, with JSON keys indicating the sale date, in the format YYYY-MM-DD

{ "2017-10-19": { ... } }

history[YYYY-MM-DD]

Property History Entry
Data type: Object

A single sale transaction entry, with historical property sale information

{ ... }

history[YYYY-MM-DD]
.event

Property History Entry - Event Type
Data type: String (Enum)

The type of the transaction, with the only possible value of "Sale"

"Sale"

history[YYYY-MM-DD]
.date

Property History Entry - Sale Date
Data type: Number

The date the property was sold, in ISO 8601 format

"2017-10-19T00:00:00.000Z"

history[YYYY-MM-DD]
.price

Property History Entry - Sale Price
Data type: Number

The sale price of the property

185000

owner

Property Owner Details
Data type: Object

Information about the current owner(s) of this property

{ ... }

owner.names

Property Owner - Names
Data type: Array

A list of names of the individuals or organizations listed as the current property owner(s). Individual owner names will typically be in the format First Middle Last

[ "Michael Smith" ]

owner.type

Property Owner - Entity Type
Data type: String (Enum)

The type of the current property owner(s), with possible values of "Individual" for individuals or persons, or "Organization" for other types of entities

"Individual"

owner.mailingAddress

Property Owner - Mailing Address
Data type: Object

The mailing address of the current property owner(s)

{ ... }

owner.mailingAddress
.id

Property Owner - Mailing Address Id
Data type: String

A unique RentCast property identifier

"149-Weaver-Blvd,---264,-Weaverville,-NC-28787"

owner.mailingAddress
.formattedAddress

Property Owner - Mailing Address Formatted
Data type: String

The full property address, in the format Street, Unit, City, State Zip

"149 Weaver Blvd, # 264, Weaverville, NC 28787"

owner.mailingAddress
.addressLine1

Property Owner - Mailing Address Line 1
Data type: String

The first line of the property street address

"149 Weaver Blvd"

owner.mailingAddress
.addressLine2

Property Owner - Mailing Address Line 2
Data type: String

The second line of the property street address, typically containing the unit or apartment identifier

"# 264"

owner.mailingAddress
.city

Property Owner - Mailing Address City
Data type: String

The city of the property address

"Weaverville"

owner.mailingAddress
.state

Property Owner - Mailing Address State
Data type: String

The state of the property address, as a 2-character abbreviation

"NC"

owner.mailingAddress
.zipCode

Property Owner - Mailing Address Zip Code
Data type: String

The 5-digit zip code of the property address

"28787"

ownerOccupied

Owner Occupied Status
Data type: Boolean

A field indicating whether the property is currently occupied by its property owner(s)

false

📘

Data availability of specific property record fields may vary by county and state. Our API will always return all available fields and data for each property.

 

Property Feature Field Values

Our property data endpoints return several descriptive property features and characteristics in the features response field, when available.

We obtain this data directly from public county records, and apply light standardization and formatting to the values of these fields to improve their consistency across various counties.

While the following lists provide the majority of possible field values with the String data type, you may encounter other values if they have been recently added by the upstream county record databases. In such cases, we encourage you to contact us so we can update our documentation.

📘

The response fields listed below may contain multiple values in the same JSON string, separated by the forward slash character (/).


Architecture Types (features.architectureType)

Possible Values
Apartment
Bi-Level
Bungalow
Cape Cod
Colonial
Condo
Contemporary
Conventional
Cottage
Custom
Duplex
European
High Rise
Historical
Mobile Home
Modern
Multi-Unit Building
Other
Raised Ranch
Rambler
Ranch
Spanish
Split Level
Townhouse
Traditional
Triplex

Cooling Types (features.coolingType)

Possible Values
Central
Commercial
Evaporative
Other
Package
Refrigeration
Wall
Window

Exterior Types (features.exteriorType)

Possible Values
Aluminum
Aluminum Siding
Asbestos Shingle
Block
Brick
Brick Veneer
Combination
Composition
Concrete
Concrete Block
Frame
Frame Siding
Marble
Marblecrete
Masonry
Metal
Other
Shingle
Siding
Stone
Stucco
Vinyl
Vinyl Siding
Wood
Wood Frame
Wood Shingle

Fireplace Types (features.fireplaceType)

Possible Values
1 Story
1 Story Brick Chimney
2 Story
2 Story Brick Chimney
Backed
Gas Log
Masonry
Other
Prefab
Single

Foundation Types (features.foundationType)

Possible Values
Block
Concrete
Concrete Block
Crawl
Footing
Masonry
Mat
Other
Pier
Pile
Post & Beam
Raft
Raised
Slab
Stone
Wood

Garage Types (features.garageType)

Possible Values
Attached
Basement
Built-in
Carport
Detached
Garage
Mixed
Other
Underground

Heating Types (features.heatingType)

Possible Values
Baseboard
Central
Electric
Floor
Forced Air
Furnace
Gas
Heat Pump
Hot Water
Oil
Other
Package
Radiant
Steam
Wall

Pool Types (features.poolType)

Possible Values
Above-Ground Pool
Community Pool
Concrete
Fiberglass
Gunite
Heated Pool
In-Ground Pool
In-Ground Vinyl Pool
Indoor Pool
Municipal
Other
Plastic
Pool and Hot Tub
Public
Reinforced Concrete
Spa

Roof Types (features.roofType)

Possible Values
Aluminum
Asbestos
Asphalt
Built-up
Composition Shingle
Concrete
Concrete Tile
Fiberglass
Gravel
Metal
Other
Roll Composition
Shake
Shingle
Slate
Tile
Wood
Wood Shake
Wood Shingle

View Types (features.viewType)

Possible Values
Average
Beach
Canal
City
Corner
Cul-de-sac
Excellent
Fair
Golf Course
Good
Lake
Mountain
Other
Park
River
Water
Waterfront