---
title: "Get Owners"
method: GET
path: "/owners"
tags: ["Owners"]
---

# Get Owners

`GET /owners`

## Request

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

Required scope: alto/read:contacts.
See glossary for definition of <a href="https://developers.vebraalto.com/guides/glossary">Owner</a>.

## Query parameters

- `active` boolean
- `property-id` string[]
- `contact-id` string[]
- `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

## Headers

- `AgencyRef` string, required

## Response `200`

Owners matching the query returned.

- AltoServicesSDKPaginationPagedResponse1AltoContactsApiModelsResponsesOwner
  - `meta` AltoServicesSDKPaginationMeta
    - `nextToken` string, nullable
  - `items` AltoContactsApiModelsResponsesOwner[], nullable
    - `id` string, nullable: The unique identifier for the resource.
    - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
      - `href` string, nullable
      - `rel` string, nullable
    - `property` AltoContactsApiModelsResponsesOwnerProperty: Represents a property belonging to a contact.
      - `id` string, nullable: The unique identifier for the resource.
      - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
        - `href` string, nullable
        - `rel` string, nullable
      - `branchId` string, nullable: Represents the branch identifier associated with the property.
    - `contact` AltoContactsApiModelsResponsesOwnerContact: Represents a contact that owns a property.
      - `id` string, nullable: The unique identifier for the resource.
      - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
        - `href` string, nullable
        - `rel` string, nullable
      - `branchId` string, nullable: Represents the branch identifier associated with the contact owner.
    - `active` boolean: Indicates whether the owner is currently active.
    - `type` 'Unknown' | 'Vendor' | 'Landlord': Represents the type of the owner.
    - `percentageShare` number, double: Represents the owner's share or interest as a percentage.
    - `createdAt` string, date-time: The date and time when the contact owner was created.
    - `modifiedAt` string, date-time: The date and time when the owner's details were last modified.

---

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