---
title: "Get Contact(s) by Id(s)"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# Get Contact(s) by Id(s)

`GET /contacts`

## Request

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

See glossary for definition of <a href="https://developers.zoopla.co.uk/docs/glossary#person">Person</a> and <a href="https://developers.zoopla.co.uk/docs/glossary#contact">Contact</a>.

## Query parameters

- `id` string[]

## Headers

- `AgencyRef` string, required

## Response `200`

Contact returned for Contact Id.

- AltoContactsApiModelsResponsesContact
  - `id` string, nullable: The unique identifier for the resource.
  - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
    - `href` string, nullable
    - `rel` string, nullable
  - `address` AltoServicesSDKModelsAddress
    - `subDwelling` string, nullable
    - `nameNumber` string, nullable
    - `street` string, nullable
    - `locality` string, nullable
    - `town` string, nullable
    - `county` string, nullable
    - `postcode` string, nullable
    - `countryCode` string, nullable
    - `uprn` string, nullable
  - `branch` AltoContactsCoreModelsDomainBranch
    - `id` string, nullable
  - `people` AltoContactsApiModelsResponsesPerson[], nullable
    - `id` string, nullable: The unique identifier for the resource.
    - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
      - `href` string, nullable
      - `rel` string, nullable
    - `title` string, nullable: The formal title of the Person.
    - `forename` string, nullable: The first or given name of the Person.
    - `surname` string, nullable: The surname of the Person.
    - `phoneNumbers` AltoContactsApiModelsResponsesPhone[], nullable
      - `preferenceOrder` integer: The numerical order in which phone numbers are to be selected.
      - `type` 'Unspecified' | 'Home' | 'Business' | 'Mobile' | 'Fax' | 'Work' | 'ISDN': The type of phone number.
      - `number` string, nullable: The telephone number for the Contact.
      - `description` string, nullable: The description of the phone number
    - `emailAddresses` AltoContactsApiModelsResponsesEmailAddress[], nullable
      - `preferenceOrder` integer: The numerical order in which email addresses are to be selected.
      - `type` 'Unknown' | 'Personal' | 'Business': The type of email address.
      - `address` string, nullable: The email address.
  - `category` 'Unknown' | 'Client' | 'Solicitor' | 'BuildingSociety' | 'Bank' | 'Publication' | 'EstateAgent' | 'ManagingAgent' | 'Developer' | 'Builder' | 'Utility' | 'Service' | 'PreviousClient' | 'Miscellaneous' | 'FinancialAdvisor' | 'Maintenance' | 'OnSiteSales' | 'ExternalPrinter' | 'OtherCategory1' | 'EstateAgentLocal' | 'Surveyor' | 'Supplier' | 'Accountant'
  - `lead` AltoContactsApiModelsResponsesLead
    - `source` AltoContactsApiModelsResponsesParameterValue
      - `code` string, nullable
      - `name` string, nullable
    - `id` integer, nullable
  - `position` AltoContactsApiModelsResponsesParameterValue
    - `code` string, nullable
    - `name` string, nullable
  - `intention` AltoContactsApiModelsResponsesParameterValue
    - `code` string, nullable
    - `name` string, nullable
  - `disposal` AltoContactsApiModelsResponsesParameterValue
    - `code` string, nullable
    - `name` string, nullable
  - `notes` string, nullable: The notes for the contact
  - `archived` boolean: The archived status of the contact.
  - `companyName` string, nullable: The company name associated with the contact.
  - `potentialVendor` boolean: Indicates whether the contact has been flagged as a potential vendor.
  - `potentialLandlord` boolean: Indicates whether the contact has been flagged as a potential landlord.
  - `applicantRequirements` AltoContactsApiModelsResponsesApplicantRequirement[], nullable
    - `id` string, nullable: The unique identifier for the resource.
    - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
      - `href` string, nullable
      - `rel` string, nullable
    - `profileIntention` string, nullable
    - `isNewBuild` boolean, nullable
    - `priceFrom` number, double, nullable
    - `priceTo` number, double, nullable
    - `bedsMin` integer, nullable
    - `isActiveProfile` boolean
    - `rentalIntention` AltoContactsApiModelsResponsesRentalIntention
      - `priceQualifier` 'Unknown' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Yearly' | 'AdHoc' | 'Daily' | 'Fortnightly' | 'FourWeekly' | 'MonthlyOnLastDay' | 'QuarterlyOnQuarterDays' | 'HalfYearly' | 'HalfYearlyOnQuarterDays'
      - `furnishing` 'Unspecified' | 'Unfurnished' | 'PartFurnished' | 'Furnished' | 'FurnishedOrUnfurnished', nullable
    - `tenureType` 'Unspecified' | 'Freehold' | 'Leasehold' | 'LeaseholdWithShareOfFreehold' | 'FlyingFreehold' | 'Commonhold' | 'ShareOfFreehold', nullable
    - `notes` string, nullable
  - `modifiedDate` string, date-time: When the contact was last modified.

## Other responses

- `400`: Validation error e.g. invalid Contact Id.

---

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