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

# Enrich person information

`GET /enrich/v1/person`

## Request

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

Enriches person information using LinkedIn URL, email, and other optional details

## Query parameters

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

## Response `200`

Person not found (status: warning)

- RestErrorResponse
  - `message` string
  - `requestId` string
  - `status` string: Status indicates the result of the operation ("success" or "error")

## Other responses

- `202`: Processing initiated, check ResultURL for final data
- `400`: Missing linkedinUrl or email
- `401`: Missing or invalid API key
- `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/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)