---
title: "List Landlords"
method: GET
path: "/landlords"
tags: ["Landlords"]
---

# List Landlords

`GET /landlords`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/landlords`
- Auth: `appAuth` (a scheme the document does not define)

Retrieves a paginated list of landlord contacts with optional filtering.

## Query parameters

- `next-token` string
- `max-results` integer
- `created-from` string, date-time
- `created-to` string, date-time
- `modified-from` string, date-time
- `modified-to` string, date-time
- `active-status` 'Active' | 'Archived' | 'All'

## Headers

- `AgencyRef` string, required

## Response `200`

OK

- AltoPropertyManagementApiModelsResponsesPagedResults1AltoPropertyManagementApiModelsResponsesLandlordListItem
  - `meta` AltoPropertyManagementApiModelsResponsesMeta
    - `nextToken` string, nullable
    - `totalItems` integer
  - `items` AltoPropertyManagementApiModelsResponsesLandlordListItem[], nullable
    - `id` integer
    - `branchId` integer
    - `address` AltoPropertyManagementApiModelsResponsesAddress
      - `subDwelling` string, nullable
      - `nameNo` string, nullable
      - `street` string, nullable
      - `locality` string, nullable
      - `town` string, nullable
      - `county` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
    - `people` AltoPropertyManagementApiModelsResponsesPerson[], nullable
      - `title` string, nullable
      - `forename` string, nullable
      - `surname` string, nullable
      - `emailAddresses` string[], nullable
      - `telephoneNumbers` string[], nullable
    - `properties` AltoPropertyManagementApiModelsResponsesLandlordProperty[], nullable
      - `subDwelling` string, nullable
      - `nameNo` string, nullable
      - `street` string, nullable
      - `locality` string, nullable
      - `town` string, nullable
      - `county` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
      - `id` integer
      - `links` AltoApiMaterialHateoasLink[], nullable
        - `href` string, nullable
        - `rel` string, nullable
    - `active` boolean
    - `createdDate` string, date-time, nullable
    - `modifiedDate` string, date-time, nullable
    - `links` AltoApiMaterialHateoasLink[], nullable
      - `href` string, nullable
      - `rel` string, nullable

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)