API Reference

Property Events

post
https://api.parcllabs.com/v1/property/event_history

Gets unit-level properties and their housing event history, including sales, listings, and rentals. The response includes detailed property information and historical event data for each specified property. A maximum of 1000 parcl_property_ids can be requested in a single POST request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
parcl_property_id
array of strings
required
length ≤ 1000

A unique id for a given property in the Parcl Labs API. Parcl_property_ids are unique and independent of each other, without any hierarchical structure. For example, the parcl_property_id for a property in Brooklyn, NY bears no relationship to the parcl_property_id for a property in the New York Metropolitan Statistical Area (MSA), even though Brooklyn is a part of the New York MSA

Parcl Property Id*
string
enum
Defaults to ALL

Type of housing event associated with the property: SALE, LISTING, RENTAL

Allowed:
string
enum

The name of the entity that owns the property at the time of the event, if owned by a named large-scale operator.

Possible values include:

AMH

TRICON

INVITATION_HOMES

HOME_PARTNERS_OF_AMERICA

PROGRESS_RESIDENTIAL

FIRSTKEY_HOMES

AMHERST

MAYMONT_HOMES

VINEBROOK_HOMES

SFR3

MY_COMMUNITY_HOMES

BLACKSTONE

BX

OPENDOOR

OFFERPAD

NULL indicates the property is not currently owned by one of these named entities

date
Defaults to 2024-12-13

Specifies the beginning of the query period for when property event metadata was last modified in the property record tracking system, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Events existing before tracking implementation are marked as 2024-12-13. Defaults to 2024-12-13

date

Specifies the end of the query period for when property event metadata was last modified in the property record tracking system, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Events existing before tracking implementation are marked as 2024-12-13. Defaults to NULL

date

Specifies the beginning of the query period, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Defaults to NULL

date

Specifies the end of the query period, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Defaults to NULL

Responses

Updated about 1 year ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago