---
title: "Get Person by Contact Id"
method: GET
path: "/contacts/{contactId}/persons/{personId}"
tags: ["Contacts"]
---

# Get Person by Contact Id

`GET /contacts/{contactId}/persons/{personId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/contacts/{contactId}/persons/{personId}`
- 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>.

## Path parameters

- `contactId` string, required
- `personId` string, required

## Headers

- `AgencyRef` string, required

## Response `200`

Person returned for Contact Id.

- AltoContactsApiModelsResponsesPersonSingle
  - `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.
  - `isContactArchived` boolean: The archived status of the contact this person belongs to.

## Other responses

- `400`: Validation error e.g. invalid Contact Id.
- `404`: Person not found.

---

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