---
title: "Property Units"
method: GET
path: "/v1/property/{property_id}/units"
tags: ["Property"]
---

# Property Units

`GET /v1/property/{property_id}/units`

## Request

- Base URL: `https://api.eliseai.com`
- URL: `https://api.eliseai.com/v1/property/{property_id}/units`
- Auth: none declared

## Path parameters

- `property_id` string, required

## Query parameters

- `include_price` boolean
- `floorplan_name` string
- `num_bedrooms` integer
- `num_bedrooms_list[]` integer[]
- `move_in_date_earliest` string, date
- `move_in_date_latest` string, date
- `lease_term_min` integer
- `lease_term_max` integer
- `unit_id` string
- `only_available` boolean
- `include_affordable` boolean

## Response `200`

Successful Response

- Unit[]
  - `id` string, required
  - `unit_number` string, required
  - `number_of_bedrooms` integer, required
  - `number_of_bathrooms` number, required
  - `square_footage` integer
  - `floor` integer
  - `floorplan_name` string
  - `floorplan_url` string
  - `images` UnitMedia[]
    - `id` string
    - `url` string, required
    - `name` string
    - `description` string
    - `type` string
    - `rank` integer
  - `availability_stage` string, required
  - `price_matrix` ExternalPriceMatrix
    - `prices` ExternalPriceMatrixContent[], required
      - `dateAvailable` string, required
      - `rent` number, required
      - `leaseTermLength` integer, required
      - `price_token` string
  - `virtual_tour_link` string
  - `external_ids` ExternalIdForUnit[]
    - `source` string, required
    - `id_type` string, required
    - `external_id` string, required
  - `date_available` string, date
  - `application_availability_status` string
  - `market_rate_unit` integer
  - `rent` integer
  - `amenities` string[]
  - `sub_building_name` string
  - `display_prices` UnitDisplayPrice[]
    - `price_type` 'base_rent' | 'total_monthly_leasing_price', required: An enumeration.
    - `amount` number, required
  - `display_price_matrices` UnitDisplayPriceMatrix[]
    - `price_type` 'base_rent' | 'total_monthly_leasing_price', required: An enumeration.
    - `matrix` ExternalPriceMatrix, required
      - `prices` ExternalPriceMatrixContent[], required
        - `dateAvailable` string, required
        - `rent` number, required
        - `leaseTermLength` integer, required
        - `price_token` string
  - `max_occupancy_settings` MaxOccupancySettings
    - `max_occupants` integer, required
    - `occupant_age_threshold_months` integer, required

## Other responses

- `401`: Not Authorized for this endpoint
- `404`: Not found
- `422`: Validation Error

## Changes

> 57 revisions in range; 2 not diffed.

- **2026-09-17** `4cc629f3a971`: 1 info
  - added the optional property `items/images` to the response with the `200` status
- **2026-09-11** `86a7c1a3de2f`: 2 info
  - added the optional property `items/display_price_matrices` to the response with the `200` status
  - added the optional property `items/display_prices` to the response with the `200` status
- **2026-07-13** `f0711414c27d`: 5 warning, 9 info
  - removed the optional property `items/price_matrix/prices/items/endTermDate` from the response with the `200` status
  - removed the optional property `items/price_matrix/prices/items/occupancyType` from the response with the `200` status
  - removed the optional property `items/price_matrix/prices/items/occupancyTypeEnum` from the response with the `200` status
  - removed the optional property `items/price_matrix/prices/items/spaceOption` from the response with the `200` status
  - …10 more

[Operation history](https://skmtc.dev/eliseai/apis/elise-api/changes/v1/property/:property_id/units/get.md)

---

[API](https://skmtc.dev/eliseai/apis/elise-api.md) - [All operations](https://skmtc.dev/eliseai/apis/elise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eliseai/apis/elise-api/revisions/5fa349dca776?raw)