{
"property": {
"id": "<string>",
"market": "<string>",
"apn": "<string>",
"apn_norm": "<string>",
"county_fips": "<string>",
"address_short": "<string>",
"street_no_unit": "<string>",
"unit": "<string>",
"city": "<string>",
"state": "<string>",
"zip": "<string>",
"latitude": 0,
"longitude": 0,
"bedrooms": 0,
"bathrooms": 123,
"sqft": 0,
"year_built": 0,
"pool": true,
"pool_type": "<string>"
},
"distance_miles": 123,
"short_term_rental": {
"coverage": {
"jurisdiction": "<string>",
"served": true,
"licence_start": "<string>",
"feed_stale": true
},
"active_permits": 0,
"multi_unit": true,
"building": true,
"first_application": "<string>",
"current_application": "<string>",
"licensed_since": "<string>",
"expires_on": "<string>",
"permit_after_purchase": true,
"days_purchase_to_permit": 0,
"owner_attributed": true,
"business_use": true,
"prior_owner_permit": true,
"manager": "<string>",
"signals": [
"<string>"
],
"data_as_of": "<string>"
},
"owner": {
"owner_occupied": true,
"absentee": true,
"is_trust": true,
"is_public": true,
"held_since": "<string>",
"months_held": 123,
"last_purchase": {
"date": "<string>",
"price": 0
},
"rental_registered": true,
"permits_last_24m": 0,
"permits_reno_last_24m": 0
},
"investor": {
"id": "<string>",
"kinds": []
}
}The Short-term rental parcel object
A parcel on a city’s short-term rental licence roll, with who holds the licence and who manages it.
GET /v1/str-parcels. Every
Property and hold Deal inside a loaded city carries
the same facts as a short_term_rental block.
Status
status | Means |
|---|---|
LICENSED | On the roll, current. |
PENDING | Applied for. |
EXPIRED | On the roll, lapsed. |
NONE | The API serves the city, and this parcel has no record. |
NONE. It means the parcel is outside every loaded city, or the market has no
published short-term rental tables. meta.coverage[].str.jurisdictions[] lists every city the build knows, and why
the API does not serve the others. So the explanation of a null is there, not on the parcel.
Attribution: whose licence is it
owner_attributed says the licence belongs to the current owner. attribution_basis says how the build settled
that:
attribution_basis | How the build settled it |
|---|---|
PURCHASE_DATE | The licence application or issue came after the purchase. |
OWNER_NAME | A name on the licence record keys to the owner. |
LICENCE_START | The purchase predates the city’s licence regime. |
ASSUMED | Nothing settles it. The API treats it as not attributed where identity is at stake. |
business_use is attribution plus “not the owner’s own home”. It is the flag that matters. It turns a holding
into a short-term rental business, sets holding_kind to RENTAL_SIGNAL, and lets the API name a parcel’s owner.
prior_owner_permit marks a licence a former owner left behind.
manager is the property-management company on the record. It is a business name, and the API serves it to every
key.
Availability
A market without published short-term rental tables answers422 str_unavailable on /v1/str-parcels and on the
str_status, str_business_use, str_operator and str_holdings_min filters. It serves every short_term_rental
and str block null. meta.coverage[].str_as_of tells you in advance.One parcel with a short-term rental record inside the geometry. The row carries the parcel, its licence facts, its owner under the identity rule and the investor that holds it, if any.
The parcel: its id (the key to GET /v1/properties/{property_id}), address, coordinates and assessor facts.
Show child attributes
Show child attributes
Miles from the reference point, rounded to 2 decimals. The reference point is lat + lng, or the centre of the property_id parcel. Null when the request had no reference point.
The parcel's licence facts. Never null here, because every listed parcel carries a record.
Show child attributes
Show child attributes
Who holds the parcel and how. This host never names the holder. redacted_reason says why the internal tier does not name them either: a prior owner's permit, a person's own home and an ASSUMED attribution keep redacted_reason not_an_investor_hold.
Show child attributes
Show child attributes
The registered investor that holds the parcel. Null when no registered investor holds it. You then reach the owner through owner.names and owner.mailing under the identity rule.
Show child attributes
Show child attributes
Was this page helpful?