> ## Documentation Index
> Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

Cities publish their own short-term rental licence and permit rolls. The build matches those rolls to parcels. So
you can list the licensed parcels around a location with
[`GET /v1/str-parcels`](/api-reference/endpoints/str-parcels). Every
[Property](/api-reference/objects/property) and hold [Deal](/api-reference/objects/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. |

A **null block** is different from `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 answers `422 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.


## Related topics

- [List short-term rental parcels](/api-reference/endpoints/str-parcels.md)
- [List licensed short-term rental parcels around a location](/api-reference/contract/list-licensed-short-term-rental-parcels-around-a-location.md)
- [Counties, cities and ZIP codes](/coverage/places.md)
- [The Property object](/api-reference/objects/property.md)
- [API reference](/api-reference/introduction.md)