---
title: "Get by ID"
method: GET
path: "/people"
tags: ["People / Search"]
---

# Get by ID

`GET /people`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/people`
- Auth: API key in header `Authorization`

**Cost:** 2 credits per call

Gets person information by its CompanyEnrich ID. You can obtain this ID from people search results, lookup responses, and other endpoints returning person information.

## Query parameters

- `id` integer, required
- `expand` string[]

## Response `200`

OK

- PersonInfo
  - `id` integer, required: The unique identifier of the person
  - `name` string, nullable: The full name of the person
  - `location` PersonLocationInfo, nullable: The location information of the person
    - `country` CountryInfo, nullable: The origin country information of the company
      - `code` string: The ISO 3166-1 alpha-2 code of the country
      - `name` string: The name of the country
      - `latitude` number, float, nullable: The latitude of the country
      - `longitude` number, float, nullable: The longitude of the country
    - `address` string, nullable
  - `first_name` string, nullable: The first name of the person
  - `last_name` string, nullable: The last name of the person
  - `socials` PersonSocialUrls: The social URLs of the person
    - `linkedin_url` string, uri, nullable: The LinkedIn URL of the company
  - `experiences` PersonExperience[]: The work experiences of the person
    - union
      - object
        - `type` 'company', required
        - `company` object, nullable
          - `id` string, uuid, required: The unique identifier of the company
          - `name` string, nullable: The name of the company
          - `domain` string, nullable: The primary domain name of the company
          - `industry` string, nullable: The main industry of the company
          - `logo_url` string, nullable: The logo URL of the company
        - `startDate` string, date, nullable
        - `endDate` string, date, nullable
        - `isCurrent` boolean
        - `isMatched` boolean
        - `position` string, nullable
        - `seniority` unknown
        - `department` unknown
      - object
        - `type` 'unknown', required
        - `companyName` string, nullable
        - `startDate` string, date, nullable
        - `endDate` string, date, nullable
        - `isCurrent` boolean
        - `isMatched` boolean
        - `position` string, nullable
        - `seniority` unknown
        - `department` unknown
  - `education` PersonEducationInfo[], nullable: The education history of the person. This field is only returned when `expand=education` is requested.
    - `institutionName` string, required: The name of the educational institution
    - `institution` CompanyHandle, nullable: The matched educational institution
      - `id` string, uuid, required: The unique identifier of the company
      - `name` string, nullable: The name of the company
      - `domain` string, nullable: The primary domain name of the company
      - `industry` string, nullable: The main industry of the company
      - `logo_url` string, nullable: The logo URL of the company
    - `socialHandle` string, nullable: The social media handle of the educational institution
    - `degree` string[], nullable: The degrees or fields of study associated with this education entry
    - `startYear` integer, nullable: The year this education entry started
    - `endYear` integer, nullable: The year this education entry ended
  - `position` string, nullable: The job position/title of the person
  - `seniority` unknown
  - `department` unknown
  - `image_url` string, nullable: The image URL of the person
  - `updated_at` string, date-time, nullable: The timestamp representing when the person's data was last updated

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)