---
title: "Enrich Person Information"
method: GET
path: "/enrich/v1/person"
tags: ["Enrichment API"]
---

# Enrich Person Information

`GET /enrich/v1/person`

Enriches a person's information using LinkedIn URL, email, and other optional details.

## Query parameters

- `linkedinUrl` string
- `email` string
- `firstName` string
- `lastName` string
- `includeMobileNumber` string

## Response `200`

Enrichment results including personal, job, and social data

- RestEnrichPersonResponse — Response structure for the person enrichment API.
  - `data` RestEnrichPersonData — Detailed data about a person from enrichment.
    - `emails` RestEnrichPersonEmail[]
      - `address` string
      - `deliverable` string
      - `isRisky` boolean
      - `type` string
    - `jobs` RestEnrichPersonJob[]
      - `company` string
      - `companyLinkedin` string
      - `companyWebsite` string
      - `duration` RestEnrichPersonJobDuration — Job duration of a person.
        - `endMonth` integer
        - `endYear` integer
        - `startMonth` integer
        - `startYear` integer
      - `isCurrent` boolean
      - `seniority` string
      - `title` string
    - `location` RestEnrichPersonLocation — Location details of a person.
      - `city` string
      - `country` string
      - `region` string
      - `timezone` string
    - `name` RestEnrichPersonName — Name details of a person.
      - `firstName` string
      - `fullName` string
      - `lastName` string
    - `phoneNumbers` RestEnrichPersonPhoneNumber[]
      - `number` string
      - `type` string
    - `profilePic` string
    - `social` RestEnrichPersonSocial — Social media details of a person.
      - `discord` RestEnrichPersonDiscord — Discord profile details of a person.
        - `username` string
      - `github` RestEnrichPersonGithub — Github profile details of a person.
        - `url` string
        - `username` string
      - `linkedin` RestEnrichPersonLinkedIn — LinkedIn profile details of a person.
        - `followerCount` integer
        - `id` string
        - `publicId` string
        - `url` string
      - `x` RestEnrichPersonX — X (formerly Twitter) profile details of a person.
        - `handle` string
        - `url` string
  - `isComplete` boolean
  - `message` string
  - `pendingFields` string[]
  - `resultUrl` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

- **2024-09-10** `32a769da53f1` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/enrich/v1/person/get.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) · [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customeros/apis/customeros-api/revisions/4bda56020ba6?raw)