---
title: "Enrich an email, a name or a domain"
method: POST
path: "/api/v1/enrich"
tags: ["Enrich"]
---

# Enrich an email, a name or a domain

`POST /api/v1/enrich`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/enrich`
- Auth: HTTP bearer

Three ways in. Send `email` to get the person behind it. Send `name` and `domain` to find that person at the company and get their checked work email. Send `domain` alone to get the company profile. The person ways cost 1 credit for a match whose email passes the check; the same person again is free, and a miss costs nothing. The company way is free.

The company way needs only the argorant:read_counts scope.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| 1 credit per person found whose email passes the check; the same person again, misses and companies are free | Spends credits | `argorant:unlock_contacts` |

## Headers

- `Idempotency-Key` string
- `X-Request-Id` string

## Request body

- union
  - object
    - `email` string, email, required: A work email to look up.
    - `name` string: A person's full name, together with domain.
    - `domain` string: A company website domain. Alone it returns the company.
  - object
    - `email` string, email: A work email to look up.
    - `name` string, required: A person's full name, together with domain.
    - `domain` string, required: A company website domain. Alone it returns the company.
  - object
    - `email` string, email: A work email to look up.
    - `name` string: A person's full name, together with domain.
    - `domain` string, required: A company website domain. Alone it returns the company.

## Response `200`

Person found or Company or No match

- object
  - `found` boolean
  - `type` string
  - `person_id` string
  - `person` object
    - `record_id` string
    - `first_name` string
    - `last_name` string
    - `full_name` string
    - `title` string
    - `seniority` string
    - `departments` string[]
    - `company` string
    - `company_normalized` string
    - `company_domain` string
    - `email` string
    - `email_status` string
    - `linkedin_url` string
    - `city` string
    - `state` string, nullable
    - `country` string
    - `industry` string
    - `industries` string[]
  - `charged` integer
  - `already_revealed` boolean
  - `deliverable` boolean
  - `verification` string

## Other responses

- `400`: 400 Bad request. `invalid_request` when neither email, name with domain, nor domain was sent.
- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `402`: 402 Payment required. `insufficient_credits` when no credit left for a match.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:unlock_contacts.
- `409`: 409 Conflict. `idempotency_conflict` when the Idempotency-Key was used with another body.
- `422`: 422 Validation error. `validation_error` when a field has the wrong type or is missing.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

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