---
title: "Retrieve enrichment results"
method: GET
path: "/enrich/v1/person/results/{id}"
tags: ["Enrichment API"]
---

# Retrieve enrichment results

`GET /enrich/v1/person/results/{id}`

## Request

- Base URL: `https://api.customeros.ai`
- URL: `https://api.customeros.ai/enrich/v1/person/results/{id}`
- Auth: API key in header `X-CUSTOMER-OS-API-KEY`
- TypeScript: <https://skmtc.dev/customeros/apis/customeros-api/docs/enrich/v1/person/results/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the results of an asynchronous person enrichment operation

## Path parameters

- `id` string, uuid, required

## Response `200`

Successfully retrieved enriched data

- RestenrichEnrichPersonResponse: Response structure for person enrichment operations
  - `data` RestenrichEnrichPersonData: Comprehensive enriched information about a person
    - `emails` RestenrichEnrichPersonEmail[]: List of email addresses associated with the person required: false
      - `address` string: Email address required: true format: email
      - `deliverable` string: Indicates if the email is deliverable required: false
      - `isRisky` boolean: Indicates if the email is considered risky required: false
      - `type` string: Type of email address required: false enum: personal,work
    - `jobs` RestenrichEnrichPersonJob[]: Employment history required: false
      - `company` string: Company name required: true
      - `companyLinkedin` string: Company's LinkedIn URL required: false format: uri
      - `companyWebsite` string: Company's website required: false format: uri
      - `duration` RestenrichEnrichPersonJobDuration: Time period of employment
        - `endMonth` integer: Ending month (1-12) required: false minimum: 1 maximum: 12
        - `endYear` integer: Ending year required: false minimum: 1900 maximum: 2100
        - `startMonth` integer: Starting month (1-12) required: false minimum: 1 maximum: 12
        - `startYear` integer: Starting year required: false minimum: 1900 maximum: 2100
      - `isCurrent` boolean: Indicates if this is the current position required: true
      - `seniority` string: Seniority level required: false enum: Junior,Mid-Level,Senior,Lead,Manager,Director,VP,C-Level
      - `title` string: Job title required: true
    - `location` RestenrichEnrichPersonLocation: Geographic and timezone information about a person
      - `city` string: City name required: false
      - `country` string: Country name required: false
      - `region` string: State or region required: false
      - `timezone` string: Timezone identifier required: false example: America/Los_Angeles
    - `name` RestenrichEnrichPersonName: Person's name details
      - `firstName` string: First name required: true minLength: 1
      - `fullName` string: Full name (typically firstName + lastName) required: false
      - `lastName` string: Last name required: true minLength: 1
    - `phoneNumbers` RestenrichEnrichPersonPhoneNumber[]: List of phone numbers required: false
      - `number` string: Phone number in E.164 format required: true pattern: ^\+[1-9]\d{1,14}$
      - `type` string: Type of phone number required: true enum: mobile,work,home,other
    - `profilePic` string: URL to person's profile picture required: false format: uri
    - `social` RestenrichEnrichPersonSocial: Collection of social media profile information
      - `discord` RestenrichEnrichPersonDiscord: Discord profile details
        - `username` string: Discord username with discriminator required: true pattern: ^.{3,32}#[0-9]{4}$
      - `github` RestenrichEnrichPersonGithub: GitHub profile details
        - `url` string: Full GitHub profile URL required: false format: uri
        - `username` string: GitHub username required: true
      - `linkedin` RestenrichEnrichPersonLinkedIn: LinkedIn specific profile details
        - `followerCount` integer: Number of LinkedIn followers required: false minimum: 0
        - `id` string: LinkedIn internal ID required: false
        - `publicId` string: LinkedIn public identifier required: false
        - `url` string: Full LinkedIn profile URL required: false format: uri
      - `x` RestenrichEnrichPersonX: X (formerly Twitter) profile details
        - `handle` string: X handle (without @) required: true
        - `url` string: Full X profile URL required: false format: uri
  - `isComplete` boolean: Indicates if all enrichment operations are complete required: true
  - `message` string: Optional message providing additional information required: false
  - `pendingFields` string[]: List of fields still being processed required: false
  - `resultUrl` string: URL to check the final result when processing is incomplete required: false format: uri
  - `status` string: Operation status required: true enum: success,error,warning

## Other responses

- `202`: Still processing, check again later
- `400`: Invalid result ID
- `401`: Missing or invalid API key
- `404`: Result not found
- `500`: Internal server error

## Changes

- **2026-07-17** `73526747b270`: 1 info
  - added the success response with the status `202`
- **2024-09-10** `32a769da53f1`: 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/customeros/apis/customeros-api/changes/enrich/v1/person/results/:id/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/73526747b270?raw)