---
title: "Retrieve enrichment information for a person"
method: GET
path: "/enrich/{connection_id}/person"
tags: ["enrich", "person"]
---

# Retrieve enrichment information for a person

`GET /enrich/{connection_id}/person`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/enrich/{connection_id}/person`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `email` string
- `twitter` string
- `name` string
- `linkedin_url` string
- `company_name` string

## Response `200`

Successful

- EnrichPerson: A person object from an enrichment integration
  - `id` string: Unique identifier for this person object
  - `created_at` string, date-time: The date that this person object was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: The last date that this person object was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `name` string: The name of the person
  - `first_name` string
  - `last_name` string
  - `title` string: The job title of the person
  - `birthdate` string: The birth date of the person
  - `image_url` string: The image URL of the person
  - `bio` string: The biography description of the person
  - `company` string: The companyorganization name of the person
  - `company_domain` string: The company's domain
  - `emails` EnrichEmail[]: An array of email addresses for this person
    - `email` string, required
    - `type` 'WORK' | 'HOME' | 'OTHER'
    - `is_verified` boolean
  - `telephones` EnrichTelephone[]: An array of telephones for this person
    - `telephone` string, required
    - `type` 'WORK' | 'HOME' | 'OTHER' | 'FAX' | 'MOBILE'
  - `twitter_handle` string: The twitter handle of the person
  - `linkedin_url` string: The LinkedIn URL of the person
  - `github_url` string: The GitHub URL of the person
  - `github_username` string: The GitHub username of the person
  - `twitter_url` string: The twitter URL of the person
  - `facebook_url` string: The Facebook URL of the person
  - `gender` 'MALE' | 'FEMALE': The gender of the person
  - `address` EnrichPersonAddress: The address of the person
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string
    - `region_code` string
    - `postal_code` string
    - `country` string
    - `country_code` string
  - `timezone` string: The timezone code of the person
  - `utc_offset` number: The timezone's hourly offset from UTC of the person
  - `work_histories` EnrichPersonWorkHistory[]
    - `company_id` string: (reference to EnrichCompany)
    - `company_name` string
    - `title` string, required
    - `start_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `end_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `location` string
    - `company_domain` string
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)