---
title: "Get a contact"
method: GET
path: "/contacts/{id}"
tags: ["Contacts"]
---

# Get a contact

`GET /contacts/{id}`

## Request

- Base URL: `https://api.parley.so/v1`
- URL: `https://api.parley.so/v1/contacts/{id}`
- Auth: HTTP bearer

Get a single contact (person) by ID.

## Path parameters

- `id` string, required: The contact ID.

## Response `200`

OK

- Contact
  - `id` string, required: The contact ID.
  - `firstName` string, required: First name. Empty for some contacts created from email.
  - `lastName` string, required: Last name. Empty for some contacts created from email.
  - `emails` string[], required: Email addresses, lowercased. A contact has at most one address for now.
  - `account` AccountRef, required: The account's type, ID, and name.
    - `type` 'account', required
    - `id` string, required: Its ID.
    - `name` string, required: The account name.
  - `projectCount` integer, required: How many projects you can see are linked to the contact. List them by filtering projects by contactId. Linking or unlinking a project doesn't change the contact's updatedAt.
  - `createdAt` string, date-time, required: When the contact was created.
  - `updatedAt` string, date-time, required: When the contact was last updated, including changes to its email address. Links to projects and field value changes do not change it.
  - `fields` object, required: Custom field values, keyed by field name, with a key for every field defined for contacts (null when unset). The value's shape follows the field's type.

## Other responses

- `400`: The request was invalid. VALIDATION_FAILED.
- `401`: Missing or invalid credentials. UNAUTHORIZED.
- `403`: You don't have permission. FORBIDDEN.
- `404`: Not found. NOT_FOUND.
- `429`: Too many requests, or a usage limit was reached. TOO_MANY_REQUESTS.

---

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