---
title: "List properties"
method: GET
path: "/v2/properties"
tags: ["Properties v2"]
---

# List properties

`GET /v2/properties`

Returns a paginated list of properties accessible to your integration.

Use this endpoint to discover available properties and their basic information.
Filter by active/inactive status to find specific properties.

**Access Control**: You will only see properties that your API credentials
have been granted access to. Contact your account manager to request access
to additional properties.

## Query parameters

- `limit` integer — Number of properties to return (max 500)
- `active_only` boolean — Whether to return only active properties
- `cursor` string — Pagination cursor from previous response. Use the next_cursor value from the previous response to get the next page.
- `organization_id` string — Optional filter to include only properties within a given organization

## Response `200`

Successful Response

- PropertiesResponse — List of properties with pagination metadata. Used for listing properties with filtering and pagination support.
  - `properties` Property[], required — Array of property objects
    - `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
  - `pagination` CursorMeta, required — Cursor metadata for cursor-based pagination. Use the cursor token to fetch the next page of results. If null, there are no more pages.
    - `next_cursor` string — Opaque cursor token for fetching the next page
    - `has_more` boolean, required — Indicates if more pages are available

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