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

# List Organization Properties

> List a stakeholder organization's properties with market-relative performance metrics.

<Warning>Requires Explore Pro Plus access.</Warning>



## OpenAPI

````yaml /openapi/v2/schema.json post /stakeholder_entities/{stakeholder_entity_id}/properties
openapi: 3.1.0
info:
  title: ApartmentIQ API V2
  version: 2.4.0
  termsOfService: https://www.getapartmentiq.com/terms
  x-logo:
    url: https://developers.apartmentiq.io/logo.svg
    altText: ApartmentIQ
  description: >-
    ApartmentIQ API V2 endpoints for account discovery, search, organization
    details, bulk Explore data, and dataset downloads.
servers:
  - url: https://data.apartmentiq.io/apartmentiq/api/v2
security:
  - bearerAuth: []
tags:
  - name: Accounts
    description: Account discovery endpoints.
  - name: Amenities
    description: Amenity discovery endpoints.
  - name: Properties
    description: Property search endpoints.
  - name: Markets
    description: Market and geo-boundary search endpoints.
  - name: Organizations
    description: Organization search endpoints.
  - name: Datasets
    description: Complete dataset snapshot downloads.
  - name: Bulk
    description: Bulk property, market, quota, and forecast exports.
paths:
  /stakeholder_entities/{stakeholder_entity_id}/properties:
    post:
      tags:
        - Organizations
      summary: List Organization Properties
      description: >-
        List a stakeholder organization's properties with market-relative
        performance metrics.


        <Warning>Requires Explore Pro Plus access.</Warning>
      operationId: listV2StakeholderEntityProperties
      parameters:
        - name: stakeholder_entity_id
          in: path
          required: true
          schema:
            type: integer
          description: ApartmentIQ stakeholder entity ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StakeholderEntityPropertiesRequest'
            example:
              account_id: '{account_id}'
              property_filters:
                property_class: A
                collected_at_gte: '2026-05-01'
                collected_at_lte: '2026-06-01'
              sort_by: ner_avg
              sort_order: asc
              page: 1
              per_page: 20
      responses:
        '200':
          description: Stakeholder organization properties and pagination metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StakeholderEntityPropertiesResponse'
              example:
                properties:
                  - id: 123
                    name: Marina View
                    address: 1 Ocean Ave, Marina Del Rey, CA
                    property_class: A
                    market_name: Los Angeles
                    submarket_name: Marina Del Rey
                    unit_count: 250
                    year_built: 1998
                    image_url: https://cdn.example.com/properties/marina-view.jpg
                    asking_rent_avg: 2450
                    asking_rent_market_avg: 2400
                    asking_rent_change: 0.021
                    asking_rent_psf_avg: 3.25
                    asking_rent_psf_market_avg: 3.15
                    asking_rent_psf_change: 0.01
                    ner_avg: 2350
                    ner_market_avg: 2300
                    ner_change: 0.02
                    ner_psf_avg: 3.1
                    ner_psf_market_avg: 3
                    ner_psf_change: 0.015
                    days_on_market_avg: 21
                    days_on_market_market_avg: 23
                    days_on_market_change: -0.05
                    exposure_percent_avg: 0.08
                    exposure_percent_market_avg: 0.09
                    exposure_percent_change: -0.01
                    occupancy_percent_avg: 0.94
                    occupancy_percent_market_avg: 0.93
                    occupancy_percent_change: 0.005
                    leased_percent_avg: 0.96
                    leased_percent_market_avg: 0.95
                    leased_percent_change: 0.006
                    concession_value_avg: 500
                    concession_value_market_avg: 450
                    concession_value_change: 0.1
                    concession_percent_avg: 0.03
                    concession_percent_market_avg: 0.025
                    concession_percent_change: 0.004
                    leased_unit_count: 12
                    google_reviews_rating: 4.3
                    stakeholder_entities:
                      - id: 78012
                        name: Greystar Real Estate Partners
                        entity_type: Property Manager
                        image_url: https://cdn.example.com/organizations/greystar.png
                    lat: '33.98'
                    lng: '-118.45'
                    unified_status: Stabilized
                pagination:
                  current_page: 1
                  total_pages: 3
                  total_count: 45
                  per_page: 20
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/ExploreProPlusAccessForbidden'
        '404':
          $ref: '#/components/responses/StakeholderEntityNotFound'
        '429':
          $ref: '#/components/responses/RateLimitExceeded'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    StakeholderEntityPropertiesRequest:
      type: object
      description: Request contract for listing a stakeholder organization's properties.
      properties:
        account_id:
          $ref: '#/components/schemas/AccountId'
        property_filters:
          $ref: '#/components/schemas/PropertyFilters'
          description: >-
            Optional property filters and metric aggregation date range. When
            stakeholder_entity_ids is provided, results are limited to
            properties associated with both the path stakeholder entity and the
            provided stakeholder entities.
        page:
          type: integer
          minimum: 1
          default: 1
          description: One-based page number. Values less than 1 are treated as 1.
        per_page:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
          description: Rows per page. Values above 100 are capped at 100.
        sort_by:
          type: string
          enum:
            - unit_count
            - year_built
            - asking_rent_avg
            - ner_avg
            - asking_rent_psf_avg
            - ner_psf_avg
            - days_on_market_avg
            - exposure_percent_avg
            - occupancy_percent_avg
            - leased_percent_avg
            - concession_value_avg
            - concession_percent_avg
          default: asking_rent_avg
          description: >-
            Metric or property field used to sort results. Invalid values are
            treated as asking_rent_avg.
        sort_order:
          type: string
          enum:
            - asc
            - desc
          default: desc
          description: Sort direction. Invalid values are treated as desc.
      required:
        - account_id
      additionalProperties: false
    StakeholderEntityPropertiesResponse:
      type: object
      description: Paginated stakeholder organization property results.
      properties:
        properties:
          type: array
          items:
            $ref: '#/components/schemas/StakeholderEntityProperty'
          description: Properties associated with the stakeholder organization.
        pagination:
          $ref: '#/components/schemas/Pagination'
          description: Pagination details for the property results.
      required:
        - properties
        - pagination
      additionalProperties: false
    AccountId:
      anyOf:
        - type: integer
        - type: string
      description: ApartmentIQ account ID used to set the request account context.
    PropertyFilters:
      type: object
      description: >-
        Filters used to select properties and constrain the metric aggregation
        date range.
      properties:
        amenity_ids:
          anyOf:
            - type: array
              items:
                anyOf:
                  - type: integer
                  - type: string
            - type: string
          description: Amenity IDs that matching properties must include.
        bathroom_count:
          anyOf:
            - type: array
              items:
                type: number
            - type: string
          description: Bathroom counts that matching properties must offer.
        bedroom_count:
          anyOf:
            - type: array
              items:
                type: integer
            - type: string
          description: Bedroom counts that matching properties must offer.
        city:
          type: string
          description: City for location-based property filtering. Use with state.
        collected_at_gte:
          type: string
          format: date
          description: >-
            Inclusive start date for metric data. Must be on or after
            2022-01-01.
        collected_at_lte:
          type: string
          format: date
          description: Inclusive end date for metric data. Must be on or after 2022-01-01.
        concession_percent_gte:
          type: number
          description: Minimum concession percentage, expressed as a decimal value.
        concession_percent_lte:
          type: number
          description: Maximum concession percentage, expressed as a decimal value.
        concession_value_gte:
          type: number
          description: Minimum advertised concession value in dollars.
        concession_value_lte:
          type: number
          description: Maximum advertised concession value in dollars.
        construction_state:
          anyOf:
            - type: array
              items:
                type: string
            - type: string
          description: Construction state filters such as existing or new_supply.
        exposure_gte:
          type: number
          description: Minimum exposure percentage, expressed as a decimal value.
        exposure_lte:
          type: number
          description: Maximum exposure percentage, expressed as a decimal value.
        geo_boundary_ids:
          anyOf:
            - type: array
              items:
                anyOf:
                  - type: integer
                  - type: string
            - type: string
          description: Geo boundary IDs used to limit matching properties by market.
        lat:
          type: number
          description: Latitude for radius search. Use with lng.
        leased_percent_gte:
          type: number
          description: Minimum leased percentage, expressed as a decimal value.
        leased_percent_lte:
          type: number
          description: Maximum leased percentage, expressed as a decimal value.
        lng:
          type: number
          description: Longitude for radius search. Use with lat.
        ner_gte:
          type: number
          description: Minimum net effective rent.
        ner_lte:
          type: number
          description: Maximum net effective rent.
        ner_per_sq_ft_gte:
          type: number
          description: Minimum net effective rent per square foot.
        ner_per_sq_ft_lte:
          type: number
          description: Maximum net effective rent per square foot.
        number_of_stories_gte:
          type: number
          description: Minimum property story count.
        number_of_stories_lte:
          type: number
          description: Maximum property story count.
        occupancy_gte:
          type: number
          description: Minimum occupancy percentage, expressed as a decimal value.
        occupancy_lte:
          type: number
          description: Maximum occupancy percentage, expressed as a decimal value.
        property_class:
          anyOf:
            - type: array
              items:
                type: string
                enum:
                  - A
                  - B
                  - C
                  - D
            - type: string
          description: 'Property class values to include. Valid values: `A`, `B`, `C`, `D`.'
        property_ids:
          type: string
          description: Comma-separated ApartmentIQ property IDs to include.
        property_type:
          anyOf:
            - type: array
              items:
                type: string
                enum:
                  - conventional
                  - student
                  - student_housing
                  - senior
                  - senior_living
                  - build_to_rent
                  - affordable
            - type: string
          description: >-
            Property type filters to include. Valid values: `conventional`,
            `student`, `student_housing`, `senior`, `senior_living`,
            `build_to_rent`, `affordable`.
        radius:
          type: number
          description: >-
            Radius in miles for lat/lng search. Values are clamped between 0 and
            30.
        renovated_units:
          type: boolean
          description: Whether matching properties must have renovated unit inventory.
        rent_gte:
          type: number
          description: Minimum advertised rent.
        rent_lte:
          type: number
          description: Maximum advertised rent.
        rent_per_sq_ft_gte:
          type: number
          description: Minimum advertised rent per square foot.
        rent_per_sq_ft_lte:
          type: number
          description: Maximum advertised rent per square foot.
        size_gte:
          type: number
          description: Minimum unit size in square feet.
        size_lte:
          type: number
          description: Maximum unit size in square feet.
        stakeholder_entity_ids:
          anyOf:
            - type: array
              items:
                anyOf:
                  - type: integer
                  - type: string
            - type: string
          description: Stakeholder entity IDs associated with matching properties.
        state:
          type: string
          description: State for location-based property filtering. Use with city.
        total_units_gte:
          type: number
          description: Minimum total property unit count.
        total_units_lte:
          type: number
          description: Maximum total property unit count.
        transaction_cap_rate_gte:
          type: number
          description: Minimum transaction capitalization rate for pro-plus users.
        transaction_cap_rate_lte:
          type: number
          description: Maximum transaction capitalization rate for pro-plus users.
        transaction_date_closed_gte:
          type: string
          format: date
          description: Inclusive earliest transaction closed date for pro-plus users.
        transaction_date_closed_lte:
          type: string
          format: date
          description: Inclusive latest transaction closed date for pro-plus users.
        transaction_price_per_unit_gte:
          type: number
          description: Minimum transaction price per unit for pro-plus users.
        transaction_price_per_unit_lte:
          type: number
          description: Maximum transaction price per unit for pro-plus users.
        unified_status:
          anyOf:
            - type: array
              items:
                type: string
                enum:
                  - stabilized
                  - planning
                  - scheduled_construction
                  - under_construction
                  - lease_up
            - type: string
          description: Unified property status values to include.
        year_built_gte:
          type: number
          description: Minimum year built.
        year_built_lte:
          type: number
          description: Maximum year built.
        zip_code:
          type: string
          description: Zip code for location-based property filtering.
      additionalProperties: false
    StakeholderEntityProperty:
      type: object
      description: >-
        Property associated with a stakeholder organization, including
        market-relative metrics.
      properties:
        id:
          type: integer
          description: ApartmentIQ property ID.
        name:
          type:
            - string
            - 'null'
          description: Property display name.
        address:
          type:
            - string
            - 'null'
          description: Property address.
        property_class:
          type:
            - string
            - 'null'
          description: Property class.
        market_name:
          type:
            - string
            - 'null'
          description: Primary market name.
        submarket_name:
          type:
            - string
            - 'null'
          description: Primary submarket name.
        unit_count:
          type:
            - integer
            - 'null'
          description: Known unit count for the property.
        year_built:
          type:
            - integer
            - 'null'
          description: Year the property was built, when known.
        image_url:
          type:
            - string
            - 'null'
          description: Image URL for the property, when available.
        asking_rent_avg:
          type:
            - number
            - 'null'
          description: Average asking rent for the property.
        asking_rent_market_avg:
          type:
            - number
            - 'null'
          description: Average asking rent for the property market.
        asking_rent_change:
          type:
            - number
            - 'null'
          description: >-
            Property asking rent percent change compared with the previous
            period.
        asking_rent_psf_avg:
          type:
            - number
            - 'null'
          description: Average asking rent per square foot for the property.
        asking_rent_psf_market_avg:
          type:
            - number
            - 'null'
          description: Average asking rent per square foot for the property market.
        asking_rent_psf_change:
          type:
            - number
            - 'null'
          description: >-
            Property asking rent per square foot percent change compared with
            the previous period.
        ner_avg:
          type:
            - number
            - 'null'
          description: Average net effective rent for the property.
        ner_market_avg:
          type:
            - number
            - 'null'
          description: Average net effective rent for the property market.
        ner_change:
          type:
            - number
            - 'null'
          description: >-
            Property net effective rent percent change compared with the
            previous period.
        ner_psf_avg:
          type:
            - number
            - 'null'
          description: Average net effective rent per square foot for the property.
        ner_psf_market_avg:
          type:
            - number
            - 'null'
          description: Average net effective rent per square foot for the property market.
        ner_psf_change:
          type:
            - number
            - 'null'
          description: >-
            Property net effective rent per square foot percent change compared
            with the previous period.
        days_on_market_avg:
          type:
            - number
            - 'null'
          description: Average days on market for the property.
        days_on_market_market_avg:
          type:
            - number
            - 'null'
          description: Average days on market for the property market.
        days_on_market_change:
          type:
            - number
            - 'null'
          description: >-
            Property days on market percent change compared with the previous
            period.
        exposure_percent_avg:
          type:
            - number
            - 'null'
          description: Average exposure percentage for the property.
        exposure_percent_market_avg:
          type:
            - number
            - 'null'
          description: Average exposure percentage for the property market.
        exposure_percent_change:
          type:
            - number
            - 'null'
          description: >-
            Property exposure percentage change compared with the previous
            period.
        occupancy_percent_avg:
          type:
            - number
            - 'null'
          description: Average occupancy percentage for the property.
        occupancy_percent_market_avg:
          type:
            - number
            - 'null'
          description: Average occupancy percentage for the property market.
        occupancy_percent_change:
          type:
            - number
            - 'null'
          description: >-
            Property occupancy percentage change compared with the previous
            period.
        leased_percent_avg:
          type:
            - number
            - 'null'
          description: Average leased percentage for the property.
        leased_percent_market_avg:
          type:
            - number
            - 'null'
          description: Average leased percentage for the property market.
        leased_percent_change:
          type:
            - number
            - 'null'
          description: Property leased percentage change compared with the previous period.
        concession_value_avg:
          type:
            - number
            - 'null'
          description: Average concession value for the property.
        concession_value_market_avg:
          type:
            - number
            - 'null'
          description: Average concession value for the property market.
        concession_value_change:
          type:
            - number
            - 'null'
          description: >-
            Property concession value percent change compared with the previous
            period.
        concession_percent_avg:
          type:
            - number
            - 'null'
          description: Average concession percentage for the property.
        concession_percent_market_avg:
          type:
            - number
            - 'null'
          description: Average concession percentage for the property market.
        concession_percent_change:
          type:
            - number
            - 'null'
          description: >-
            Property concession percentage change compared with the previous
            period.
        leased_unit_count:
          type:
            - integer
            - 'null'
          description: Count of leased units in the selected period.
        google_reviews_rating:
          type:
            - number
            - 'null'
          description: >-
            Latest Google reviews average rating within the selected period,
            when available.
        stakeholder_entities:
          type: array
          items:
            $ref: '#/components/schemas/StakeholderEntityPropertyStakeholder'
          description: Serialized stakeholder entities associated with the property.
        lat:
          type:
            - string
            - 'null'
          description: Property latitude.
        lng:
          type:
            - string
            - 'null'
          description: Property longitude.
        unified_status:
          type:
            - string
            - 'null'
          description: Current ApartmentIQ status for the property.
      required:
        - id
        - name
        - address
        - property_class
        - market_name
        - submarket_name
        - unit_count
        - year_built
        - image_url
        - asking_rent_avg
        - asking_rent_market_avg
        - asking_rent_change
        - asking_rent_psf_avg
        - asking_rent_psf_market_avg
        - asking_rent_psf_change
        - ner_avg
        - ner_market_avg
        - ner_change
        - ner_psf_avg
        - ner_psf_market_avg
        - ner_psf_change
        - days_on_market_avg
        - days_on_market_market_avg
        - days_on_market_change
        - exposure_percent_avg
        - exposure_percent_market_avg
        - exposure_percent_change
        - occupancy_percent_avg
        - occupancy_percent_market_avg
        - occupancy_percent_change
        - leased_percent_avg
        - leased_percent_market_avg
        - leased_percent_change
        - concession_value_avg
        - concession_value_market_avg
        - concession_value_change
        - concession_percent_avg
        - concession_percent_market_avg
        - concession_percent_change
        - leased_unit_count
        - google_reviews_rating
        - stakeholder_entities
        - lat
        - lng
        - unified_status
      additionalProperties: false
    Pagination:
      type: object
      properties:
        current_page:
          type: integer
          description: Current page number in the result set.
        total_pages:
          type: integer
          description: Total number of pages available for the request.
        total_count:
          type: integer
          description: Total number of matching records across all pages.
        per_page:
          type: integer
          description: Maximum number of records returned per page.
      required:
        - current_page
        - total_pages
        - total_count
        - per_page
      additionalProperties: false
      description: Pagination details for list-style responses.
    Error:
      type: object
      description: Error response payload.
      properties:
        error:
          type: string
          description: Short error message.
        message:
          type: string
          description: Additional error details, when available.
        quota_limit:
          type: integer
          description: Quota limit that applied to the request, when relevant.
        quota_usage:
          type: integer
          description: Quota already used, when relevant.
      required:
        - error
      additionalProperties: true
    StakeholderEntityPropertyStakeholder:
      type: object
      description: Stakeholder entity associated with a property.
      properties:
        id:
          type: integer
          description: ApartmentIQ stakeholder entity ID.
        name:
          type:
            - string
            - 'null'
          description: Display name for the stakeholder entity.
        entity_type:
          type:
            - string
            - 'null'
          description: Display entity type, such as Property Manager or Owner.
        image_url:
          type:
            - string
            - 'null'
          description: Logo or image URL for the stakeholder entity, when available.
      required:
        - id
        - name
        - entity_type
        - image_url
      additionalProperties: false
  responses:
    BadRequest:
      description: The request was invalid or malformed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized - Invalid or missing authentication.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ExploreProPlusAccessForbidden:
      description: Forbidden - The user lacks account access or Explore Pro Plus access.
    StakeholderEntityNotFound:
      description: Stakeholder entity not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Stakeholder entity not found
    RateLimitExceeded:
      description: >-
        Rate limit exceeded. Inspect the rate limit headers and wait before
        retrying.
      headers:
        X-RateLimit-Limit:
          description: The limit that applied to the request.
          schema:
            type: string
        X-RateLimit-Reset-After:
          description: The rate limit window length, in seconds.
          schema:
            type: string
        X-RateLimit-Reset:
          description: Unix timestamp when the current window resets.
          schema:
            type: string
        Retry-After:
          description: Seconds to wait before retrying the request.
          schema:
            type: string
      content:
        text/plain:
          schema:
            type: string
          example: |
            You have exceeded the rate limit for this API.
    InternalServerError:
      description: An unexpected error occurred while processing the request.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````