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

# List tenancies

### Request

This request supports pagination.

### Response

<ResponseField name="tenancies" type="array">
  <Expandable>
    <ResponseField name="id" type="string">
      The unique identifier for the tenancy
    </ResponseField>

    <ResponseField name="address" type="object">
      The address details of the tenancy

      <Expandable>
        <ResponseField name="street" type="string">
          The full street name and number
        </ResponseField>

        <ResponseField name="streetName" type="string">
          The name of the street
        </ResponseField>

        <ResponseField name="streetNumber" type="string">
          The number of the property on the street
        </ResponseField>

        <ResponseField name="floor" type="string">
          The floor of the address if applicable
        </ResponseField>

        <ResponseField name="door" type="string">
          The door of the address if applicable
        </ResponseField>

        <ResponseField name="subdivision" type="string">
          The subdivision of the address if applicable
        </ResponseField>

        <ResponseField name="postalCode" type="string">
          The postal code for the address
        </ResponseField>

        <ResponseField name="city" type="string">
          The city of the address
        </ResponseField>

        <ResponseField name="country" type="string">
          The country code of the address
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="groupId" type="object">
      Categories mapped to the corresponding groups
    </ResponseField>

    <ResponseField name="currentLease" type="object">
      The details of the Current Lease Object for the tenancy

      <Expandable>
        <ResponseField name="id" type="string">
          The unique identifier for the lease
        </ResponseField>

        <ResponseField name="tenancyId" type="string">
          The identifier for the tenancy associated with the lease
        </ResponseField>

        <ResponseField name="operationalState" type="string">
          The operational state of the lease (e.g., "Draft")
        </ResponseField>

        <ResponseField name="contractPeriodState" type="string">
          The state of the contract period (e.g., "Active")
        </ResponseField>

        <ResponseField name="primaryTenantContactName" type="string">
          The name of the primary tenant contact
        </ResponseField>

        <ResponseField name="tenantIds" type="array">
          The identifiers for the tenants
        </ResponseField>

        <ResponseField name="associatedContactIds" type="array">
          The identifiers for the associated contacts
        </ResponseField>

        <ResponseField name="primaryTenantId" type="string">
          The identifier for the primary tenant
        </ResponseField>

        <ResponseField name="billingContactId" type="string">
          The identifier for the billing contact
        </ResponseField>

        <ResponseField name="balance" type="object">
          The balance for the lease

          <Expandable>
            <ResponseField name="currency" type="string">
              The currency code for the balance amount (e.g., "DKK")
            </ResponseField>

            <ResponseField name="amount" type="number">
              The amount of balance amount (e.g., 100.00)
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="depositBalance" type="object">
          The deposit balance for the lease

          <Expandable>
            <ResponseField name="currency" type="string">
              The currency code for the deposit balance amount (e.g., "DKK")
            </ResponseField>

            <ResponseField name="amount" type="number">
              The amount of the prepaid balance amount (e.g., 100.00)
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="prepaidBalance" type="object">
          The prepaid balance for the lease

          <Expandable>
            <ResponseField name="currency" type="string">
              The currency code for the balance amount (e.g., "DKK")
            </ResponseField>

            <ResponseField name="amount" type="number">
              The amount of prepaid balance amount (e.g., 100.00)
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="contractStart" type="date">
          The start date of the contract in ISO 8601 format
        </ResponseField>

        <ResponseField name="contractEnd" type="date">
          The end date of the contract in ISO 8601 format
        </ResponseField>

        <ResponseField name="purpose" type="string">
          The purpose of the lease (e.g., "key:residential")
        </ResponseField>

        <ResponseField name="monthlyRentLevel" type="object">
          The monthly rent level details for the lease

          <Expandable>
            <ResponseField name="currency" type="string">
              The currency code for the monthly rent level (e.g., "DKK")
            </ResponseField>

            <ResponseField name="amount" type="number">
              The amount of the monthly rent level
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="archivedAt" type="date">
          The date-time in ISO 8601 format of archiving the lease
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="leaseIds" type="array">
      The identifiers for all leases associated with the tenancy
    </ResponseField>

    <ResponseField name="unitType" type="string">
      The type of the unit (e.g., "PARKING")
    </ResponseField>

    <ResponseField name="unitTypeName" type="string">
      The description of unit type, if unit type is "OTHER"
    </ResponseField>

    <ResponseField name="roomCounts" type="array">
      <Expandable>
        <ResponseField name="type" type="string">
          The type of the room (e.g., "ROOM")
        </ResponseField>

        <ResponseField name="count" type="integer">
          The count of the room type
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="totalArea" type="object">
      The total area of the tenancy

      <Expandable>
        <ResponseField name="value" type="number">
          The value of the total area
        </ResponseField>

        <ResponseField name="unit" type="string">
          The unit of measurement for the area (e.g., "m²")
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="businessArea" type="object">
      The business area of the tenancy

      <Expandable>
        <ResponseField name="value" type="number">
          The value of the business area
        </ResponseField>

        <ResponseField name="unit" type="string">
          The unit of measurement for the area (e.g., "m²")
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="archivedAt" type="date">
      The date-time in ISO 8601 format of archiving the tenancy
    </ResponseField>
  </Expandable>
</ResponseField>