---
title: "Enrich a person"
method: POST
path: "/v1/data/agnt/people/enrich"
tags: ["superagnt_ Lead APIs: People — Enrich"]
---

# Enrich a person

`POST /v1/data/agnt/people/enrich`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/agnt/people/enrich`
- Auth: API key in header `Authorization`

Enrich a person with normalized fields (email, mobile, job title, company, LinkedIn URL, location, …). REQUIRES a `identifiers` object containing ONLY `email` and/or `linkedin_url` — these are the unique handles we use to resolve the person upstream. `first_name`, `last_name`, `domain`, `company`, etc. are NOT accepted here and will return a VALIDATION_ERROR. If you only have a name + company, call `/people/email-finder` first to obtain an email, then pass that email here. Optional `fields[]` narrows the waterfall to only fetch the fields you care about. agntdata runs a field-aware waterfall: it stops once all requested fields are filled or your `max_cost_cents` budget is exhausted.

## Request body

- PeopleEnrichRequest (unresolved $ref)

## Response `200`

Person enrichment result.

- object
  - `success` true, required
  - `data` PeopleEnrichResponse, required (unresolved $ref)
  - `meta` AgntMeta (unresolved $ref)

## Other responses

- `400`: Validation error.
- `401`: Unauthorized.
- `402`: Insufficient credits.

---

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