---
title: "Fetch a person by email"
method: POST
path: "/people/fetch_by_email"
tags: ["People"]
---

# Fetch a person by email

`POST /people/fetch_by_email`

## Request

- Base URL: `https://api.copper.com/developer_api/v1`
- URL: `https://api.copper.com/developer_api/v1/people/fetch_by_email`
- Auth: HTTP bearer

Email address is a unique key for People records in Copper. You can fetch a Person by its email address using this operation. This endpoint is eligible to return computed custom field values.

## Query parameters

- `custom_field_computed_values` boolean

## Request body

- object
  - `email` string, email, required: The email address to search for

## Response `200`

Person retrieved successfully

- Person
  - `id` integer, required: Unique identifier for the person
  - `name` string, required: The first and last name of the person
  - `prefix` string, nullable: Name prefix
  - `first_name` string: First name of the person
  - `middle_name` string, nullable: Middle name of the person
  - `last_name` string: Last name of the person
  - `suffix` string, nullable: Name suffix
  - `address` object, nullable: An object containing the person's address
    - `street` string
    - `city` string
    - `state` string
    - `postal_code` string
    - `country` string
  - `assignee_id` integer, nullable: Unique identifier of the user that will be the owner of the person
  - `company_id` integer, nullable: ID of the associated company
  - `company_name` string, nullable: Name of the associated company
  - `contact_type_id` integer: Unique identifier of the contact type
  - `details` string, nullable: Description of the person
  - `emails` object[]: An array of email addresses belonging to the person
    - `email` string, email
    - `category` string
  - `phone_numbers` object[]: An array of phone numbers belonging to the person
    - `number` string: A phone number
    - `category` string: The category of the phone number
  - `socials` object[]: An array of social profiles belonging to the person
    - `url` string: The URL of a social profile
    - `category` string: The category of the social profile
  - `tags` string[]: An array of the tags associated with the person
  - `title` string, nullable: The professional title of the person
  - `websites` object[]: An array of websites belonging to the person
    - `url` string: The URL of a website
    - `category` string: The category of the website
  - `custom_fields` object[]: An array of custom field values belonging to the person. When custom_field_computed_values query parameter is true, each field will include a computed_value with human-readable labels for Dropdown and Multi-select fields.
    - `custom_field_definition_id` integer: The id of the custom field definition for which this custom field stores a value
    - `value` unknown
    - `computed_value` unknown
  - `date_created` integer: A Unix timestamp representing the time at which this person was created
  - `date_modified` integer: A Unix timestamp representing the time at which this person was last modified
  - `date_last_contacted` integer, nullable: A Unix timestamp representing the time at which this person was last contacted
  - `interaction_count` integer: The number of interactions with this person
  - `leads_converted_from` integer[]: An array of lead IDs that were converted to this person
  - `date_lead_created` integer, nullable: A Unix timestamp representing when the lead was created before conversion

## Other responses

- `400`: Bad Request - The request was invalid or cannot be served
- `401`: Unauthorized - Authentication credentials were missing or incorrect
- `404`: Not Found - The requested resource was not found
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/copper/apis/copper-crm-read-only-api.md) - [All operations](https://skmtc.dev/copper/apis/copper-crm-read-only-api/llms.txt) - [OpenAPI document](https://skmtc.dev/copper/apis/copper-crm-read-only-api/revisions/96adc8557a40?raw)