openapi: 3.1.0
info:
title: RentCast Avm Properties API
version: '1.0'
servers:
- url: https://api.rentcast.io/v1
security:
- sec0: []
tags:
- name: Properties
paths:
/properties:
get:
summary: Property Records
description: Search for property records in a geographical area, or by a specific address.
operationId: property-records
parameters:
- name: address
in: query
description: The **full address** of the property, in the format `Street, City, State, Zip`. Used to retrieve data for a specific property, or together with the `radius` parameter to search for properties in a circular area
schema:
type: string
default: 5500 Grand Lake Dr, San Antonio, TX, 78244
- name: city
in: query
description: The name of the city, used to search for properties in a specific city. This parameter is case-sensitive
schema:
type: string
- name: state
in: query
description: The 2-character state abbreviation, used to search for properties in a specific state. This parameter is case-sensitive
schema:
type: string
- name: zipCode
in: query
description: The 5-digit zip code, used to search for properties in a specific zip code
schema:
type: string
- name: latitude
in: query
description: The latitude of the search area. Use the `latitude`/`longitude` and `radius` parameters to search for properties in a circular area
schema:
type: number
format: float
- name: longitude
in: query
description: The longitude of the search area. Use the `latitude`/`longitude` and `radius` parameters to search for properties in a circular area
schema:
type: number
format: float
- name: radius
in: query
description: The radius of the search area in miles, with a maximum of 100. Use in combination with the `latitude`/`longitude` or `address` parameters to search for properties in a circular area
schema:
type: number
format: float
- name: propertyType
in: query
description: The type of the property, used to search for properties matching this criteria. See [explanation of property types](https://developers.rentcast.io/reference/property-types). Supports [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
enum:
- Single Family
- Condo
- Townhouse
- Manufactured
- Multi-Family
- Apartment
- Land
- name: bedrooms
in: query
description: The number of bedrooms, used to search for properties matching this criteria. Use `0` to indicate a studio layout. Supports [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters) and [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
- name: bathrooms
in: query
description: The number of bathrooms, used to search for properties matching this criteria. Supports fractions to indicate partial bathrooms, [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters) and [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
- name: squareFootage
in: query
description: The total living area size in square feet, used to search for properties matching this criteria. Supports [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters) and [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
- name: lotSize
in: query
description: The total lot size in square feet, used to search for properties matching this criteria. Supports [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters) and [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
- name: yearBuilt
in: query
description: The year of construction, used to search for properties matching this criteria. Supports [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters) and [multiple values](https://developers.rentcast.io/reference/search-queries#using-multiple-value-parameters)
schema:
type: string
- in: query
name: saleDateRange
schema:
type: string
description: The number of days since a property was last sold, with a minimum of 1. Used to search for properties that were sold within the specified date range. Supports [numeric ranges](https://developers.rentcast.io/reference/search-queries#using-numeric-range-parameters)
- in: query
name: limit
schema:
type: integer
format: int32
description: The maximum number of property records to return, between 1 and 500. Defaults to `50` if not provided. [Learn more](https://developers.rentcast.io/reference/pagination) about pagination
- in: query
name: offset
schema:
type: integer
format: int32
description: The index of the first property record to return, used to paginate through large lists of results. Defaults to `0` if not provided. [Learn more](https://developers.rentcast.io/reference/pagination) about pagination
- in: query
name: includeTotalCount
schema:
type: boolean
description: When enabled, will return the total number of results matching the current query in the `X-Total-Count` response header. Defaults to `false` if not provided
responses:
'200':
description: Success
content:
application/json:
examples:
Success:
summary: Success
value:
- id: 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244
formattedAddress: 5500 Grand Lake Dr, San Antonio, TX 78244
addressLine1: 5500 Grand Lake Dr
addressLine2: null
city: San Antonio
state: TX
stateFips: '48'
zipCode: '78244'
county: Bexar
countyFips: 029
latitude: 29.475962
longitude: -98.351442
propertyType: Single Family
bedrooms: 3
bathrooms: 2
squareFootage: 1878
lotSize: 8850
yearBuilt: 1973
assessorID: 05076-103-0500
legalDescription: CB 5076A BLK 3 LOT 50
subdivision: WOODLAKE
zoning: RH
lastSaleDate: '2024-11-18T00:00:00.000Z'
lastSalePrice: 270000
hoa:
fee: 175
features:
architectureType: Contemporary
cooling: true
coolingType: Central
exteriorType: Wood
fireplace: true
fireplaceType: Masonry
floorCount: 1
foundationType: Slab / Mat / Raft
garage: true
garageSpaces: 2
garageType: Garage
heating: true
heatingType: Forced Air
pool: true
poolType: Concrete
roofType: Asphalt
roomCount: 5
unitCount: 1
viewType: City
taxAssessments:
'2020':
year: 2020
value: 142610
land: 23450
improvements: 119160
'2021':
year: 2021
value: 163440
land: 45050
improvements: 118390
'2022':
year: 2022
value: 197600
land: 49560
improvements: 148040
'2023':
year: 2023
value: 225790
land: 59380
improvements: 166410
'2024':
year: 2024
value: 216513
land: 59380
improvements: 157133
propertyTaxes:
'2020':
year: 2020
total: 3023
'2021':
year: 2021
total: 3455
'2022':
year: 2022
total: 4077
'2023':
year: 2023
total: 4201
'2024':
year: 2024
total: 4065
history:
'2017-10-19':
event: Sale
date: '2017-10-19T00:00:00.000Z'
price: 185000
'2024-11-18':
event: Sale
date: '2024-11-18T00:00:00.000Z'
price: 270000
owner:
names:
- Rolando Villarreal
type: Individual
mailingAddress:
id: 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244
formattedAddress: 5500 Grand Lake Dr, San Antonio, TX 78244
addressLine1: 5500 Grand Lake Dr
addressLine2: null
city: San Antonio
state: TX
stateFips: '48'
zipCode: '78244'
ownerOccupied: true
schema:
type: array
items:
type: object
properties:
id:
type: string
example: 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244
formattedAddress:
type: string
example: 5500 Grand Lake Dr, San Antonio, TX 78244
addressLine1:
type: string
example: 5500 Grand Lake Dr
addressLine2: {}
city:
type: string
example: San Antonio
state:
type: string
example: TX
zipCode:
type: string
example: '78244'
county:
type: string
example: Bexar
latitude:
type: number
example: 29.476011
default: 0
longitude:
type: number
example: -98.351454
default: 0
propertyType:
type: string
example: Single Family
bedrooms:
type: integer
example: 3
default: 0
bathrooms:
type: integer
example: 2
default: 0
squareFootage:
type: integer
example: 1878
default: 0
lotSize:
type: integer
example: 8843
default: 0
yearBuilt:
type: integer
example: 1973
default: 0
assessorID:
type: string
example: 05076-103-0500
legalDescription:
type: string
example: CB 5076A BLK 3 LOT 50
subdivision:
type: string
example: CONV A/S CODE
zoning:
type: string
example: RH
lastSaleDate:
type: string
example: '2017-10-19T00:00:00.000Z'
lastSalePrice:
type: integer
example: 185000
default: 0
hoa:
type: object
properties:
fee:
type: integer
example: 175
default: 0
features:
type: object
properties:
architectureType:
type: string
example: Contemporary
cooling:
type: boolean
example: true
default: true
coolingType:
type: string
example: Central
exteriorType:
type: string
example: Wood
fireplace:
type: boolean
example: true
default: true
fireplaceType:
type: string
example: Masonry
floorCount:
type: integer
example: 1
default: 0
foundationType:
type: string
example: Slab / Mat / Raft
garage:
type: boolean
example: true
default: true
garageSpaces:
type: integer
example: 2
default: 0
garageType:
type: string
example: Garage
heating:
type: boolean
example: true
default: true
heatingType:
type: string
example: Forced Air
pool:
type: boolean
example: true
default: true
poolType:
type: string
example: Concrete
roofType:
type: string
example: Asphalt
roomCount:
type: integer
example: 5
default: 0
unitCount:
type: integer
example: 1
default: 0
viewType:
type: string
example: City
taxAssessments:
type: object
properties:
'2019':
type: object
properties:
year:
type: integer
example: 2019
default: 0
value:
type: integer
example: 135430
default: 0
land:
type: integer
example: 23450
default: 0
improvements:
type: integer
example: 111980
default: 0
'2020':
type: object
properties:
year:
type: integer
example: 2020
default: 0
value:
type: integer
example: 142610
default: 0
land:
type: integer
example: 23450
default: 0
improvements:
type: integer
example: 119160
default: 0
'2021':
type: object
properties:
year:
type: integer
example: 2021
default: 0
value:
type: integer
example: 163440
default: 0
land:
type: integer
example: 45050
default: 0
improvements:
type: integer
example: 118390
default: 0
'2022':
type: object
properties:
year:
type: integer
example: 2022
default: 0
value:
type: integer
example: 197600
default: 0
land:
type: integer
example: 49560
default: 0
improvements:
type: integer
example: 148040
default: 0
'2023':
type: object
properties:
year:
type: integer
example: 2023
default: 0
value:
type: integer
example: 225790
default: 0
land:
type: integer
example: 59380
default: 0
improvements:
type: integer
example: 166410
default: 0
propertyTaxes:
type: object
properties:
'2019':
type: object
properties:
year:
type: integer
example: 2019
default: 0
total:
type: integer
example: 2984
default: 0
'2020':
type: object
properties:
year:
type: integer
example: 2020
default: 0
total:
type: integer
example: 3023
default: 0
'2021':
type: object
properties:
year:
type: integer
example: 2021
default: 0
total:
type: integer
example: 3455
default: 0
'2022':
type: object
properties:
year:
type: integer
example: 2022
default: 0
total:
type: integer
example: 4091
default: 0
'2023':
type: object
properties:
year:
type: integer
example: 2023
default: 0
total:
type: integer
example: 4201
default: 0
history:
type: object
properties:
'2004-06-16':
type: object
properties:
event:
type: string
example: Sale
date:
type: string
example: '2004-06-16T00:00:00.000Z'
price:
type: integer
example: 95000
default: 0
'2017-10-19':
type: object
properties:
event:
type: string
example: Sale
date:
type: string
example: '2017-10-19T00:00:00.000Z'
price:
type: integer
example: 185000
default: 0
owner:
type: object
properties:
names:
type: array
items:
type: string
example: Michael Smith
type:
type: string
example: Individual
mailingAddress:
type: object
properties:
id:
type: string
example: 149-Weaver-Blvd,---264,-Weaverville,-NC-28787
formattedAddress:
type: string
example: '149 Weaver Blvd, # 264, Weaverville, NC 28787'
addressLine1:
type: string
example: 149 Weaver Blvd
addressLine2:
type: string
example: '# 264'
city:
type: string
example: Weaverville
state:
type: string
example: NC
zipCode:
type: string
example: '28787'
ownerOccupied:
type: boolean
example: false
default: true
'401':
description: Auth Error
content:
application/json:
examples:
Auth Error:
value:
status: 401
error: auth/api-key-invalid
message: No API key provided in request. An API key must be provided in the 'X-Api-Key' header
summary: Auth Error
schema:
properties:
status:
type: integer
error:
type: string
message:
type: string
type: object
deprecated: false
tags:
- Properties
/properties/random:
get:
summary: Random Property Records
description: Returns a list of property records selected at random.
operationId: property-records-random
parameters:
- name: limit
in: query
description: The number of property records to return, between 1 and 500. Defaults to `50` if not provided
schema:
type: integer
default: 5
format: int32
responses:
'200':
description: Success
content:
application/json:
examples:
Success:
value:
- id: 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244
formattedAddress: 5500 Grand Lake Dr, San Antonio, TX 78244
addressLine1: 5500 Grand Lake Dr
addressLine2: null
city: San Antonio
state: TX
stateFips: '48'
zipCode: '78244'
county: Bexar
countyFips: 029
latitude: 29.475962
longitude: -98.351442
propertyType: Single Family
bedrooms: 3
bathrooms: 2
squareFootage: 1878
lotSize: 8850
yearBuilt: 1973
assessorID: 05076-103-0500
legalDescription: CB 5076A BLK 3 LOT 50
subdivision: WOODLAKE
zoning: RH
lastSaleDate: '2024-11-18T00:00:00.000Z'
lastSalePrice: 270000
hoa:
fee: 175
features:
architectureType: Contemporary
cooling: true
coolingType: Central
exteriorType: Wood
fireplace: true
fireplaceType: Masonry
floorCount: 1
foundationType: Slab / Mat / Raft
garage: true
garageSpaces: 2
garageType: Garage
heating: true
heatingType: Forced Air
pool: true
poolType: Concrete
roofType: Asphalt
roomCount: 5
unitCount: 1
viewType: City
taxAssessments:
'2020':
year: 2020
value: 142610
land: 23450
improvements: 119160
'2021':
year: 2021
value: 163440
land: 45050
improvements: 118390
'2022':
year: 2022
value: 197600
land: 49560
improvements: 148040
'2023':
year: 2023
value: 225790
land: 59380
improvements: 166410
'2024':
year: 2024
value: 216513
land: 59380
improvements: 157133
propertyTaxes:
'2020':
year: 2020
total: 3023
'2021':
year: 2021
total: 3455
'2022':
year: 2022
total: 4077
'2023':
year: 2023
total: 4201
'2024':
year: 2024
total: 4065
history:
'2017-10-19':
event: Sale
date: '2017-10-19T00:00:00.000Z'
price: 185000
'2024-11-18':
event: Sale
date: '2024-11-18T00:00:00.000Z'
price: 270000
owner:
names:
- Rolando Villarreal
type: Individual
mailingAddress:
id: 5500-Grand-Lake-Dr,-San-Antonio,-TX-78244
formattedAddress: 5500 Grand Lake Dr, San Antonio, TX 78244
addressLine1: 5500 Grand Lake Dr
addressLine2: null
city: San Antonio
state: TX
stateFips: '48'
zipCode: '78244'
ownerOccupied: true
- id: 1824-Nw-32nd-St,-Oklahoma-City,-OK-73118
formattedAddress: 1824 Nw 32nd St, Oklahoma City, OK 73118
addressLine1: 1824 Nw 32nd St
addressLine2: null
city: Oklahoma City
state: OK
stateFips: '40'
zipCode: '73118'
county: Oklahoma
countyFips: '109'
latitude: 35.502556
longitude: -97.543355
propertyType: Single Family
bedrooms: 2
bathrooms: 1
squareFootage: 1205
lotSize: 12763
yearBuilt: 1935
assessorID: 05-155-6980
legalDescription: MILITARY PARK ADD 037 000 LOTS 3 4 & 5
subdivision: MILITARY PARK ADD
lastSaleDate: '2019-10-02T00:00:00.000Z'
lastSalePrice: 92650
features:
architectureType: Ranch
cooling: true
coolingType: Central
exteriorType: Brick Veneer
fireplace: true
floorCount: 1
foundationType: Raised
garage: true
garageSpaces: 2
garageType: Carport
heating: true
hea
# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/rentcast/refs/heads/main/openapi/rentcast-properties-api-openapi.yml