---
title: "Retrieve a property"
method: GET
path: "/v2/properties/{property_id}"
tags: ["Properties v2"]
---

# Retrieve a property

`GET /v2/properties/{property_id}`

Retrieves comprehensive details for a specific property.

Returns full property information including address, property type, status,
total units, and external system identifiers. Use this to get complete
property context before making other API calls.

**Property IDs**: Property IDs are permanent and unique across the system.
Use the same ID format returned from the list properties endpoint.

## Path parameters

- `property_id` string, required — The property ID

## Response `200`

Successful Response

- Property — A property represents a building or complex with residential units. This is the top-level entity that contains units, has leases, and manages resident relationships. All financial transactions and operational activities are associated with a property.
  - `id` string, required — Unique identifier for the property
  - `name` string, required — Property name for display
  - `property_type` 'multi_family' | 'single_family' | 'other', required — Types of properties managed in the system
  - `status` 'active' | 'inactive', required — Current operational status of the property
  - `address` Address, required — Physical address for a property. Structured address components support accurate geocoding and utility provider matching for billing integrations.
    - `street_address` string, required — Street number and name
    - `unit_number` string — Unit/suite/apartment number if applicable
    - `city` string, required — City name
    - `state` string, required — State or province code
    - `postal_code` string, required — ZIP or postal code
    - `country` string — ISO 3166-1 alpha-2 country code
  - `total_units` integer — Total number of units in the property
  - `external_ids` ExternalId[] — List of external system identifiers for this property
    - `source` string, required — Source system of the external ID
    - `id_type` string, required — Type of external ID
    - `external_id` string, required — The external identifier value
  - `organization_id` string — Organization ID for the property. Denotes who manages the property
  - `has_phases` boolean — Whether the entities list contains a SUB_PROPERTY entity
  - `entities` PropertyEntity[] — Active PROPERTY and SUB_PROPERTY GL Catalog entities for this property
    - `id` string, required — Unique identifier for the entity
    - `name` string, required — Entity display name
    - `type` 'PROPERTY' | 'SUB_PROPERTY', required — An enumeration.
    - `building_ids` string[] — Building IDs grouped under this entity
  - `buildings` PropertySubBuilding[] — Buildings at this property (such as towers or distinct addresses); empty when none are configured
    - `id` string, required — Unique identifier for the sub-building
    - `name` string, required — Sub-building display name
    - `address` SubBuildingAddress, required — Mailing address for a building (no unit / suite line).
      - `street_address` string, required — Street number and name
      - `city` string, required — City name
      - `state` string, required — State or province code
      - `postal_code` string, required — ZIP or postal code
      - `country` string — ISO 3166-1 alpha-2 country code

## Other responses

- `400` — Bad request - invalid parameters
- `401` — Unauthorized - invalid or missing API key
- `403` — Forbidden - insufficient permissions
- `404` — Not found - resource doesn't exist
- `422` — Unprocessable entity - validation error
- `500` — Internal server error
- `501` — Not implemented
- `503` — Property entity topology is temporarily unavailable

---

[API](https://skmtc.net/eliseai/apis/elise-api.md) · [All operations](https://skmtc.net/eliseai/apis/elise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eliseai/elise-api/versions/a75af086c674/schema)