---
title: "Enrich a person by email"
method: GET
path: "/leads/enrich"
tags: ["Leads"]
---

# Enrich a person by email

`GET /leads/enrich`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/leads/enrich`
- Auth: API key in header `Authorization`

Returns known professional details for a person from their email address — name, location, employment and social profiles. Backed by Hunter.io. Costs 2 credits per call.

## Query parameters

- `email` string, required

## Response `200`

Enriched person data

- object
  - `object` 'lead_person_enrichment'
  - `found` boolean, nullable: False when Hunter has no match for the email.
  - `email` string, nullable
  - `name` object
    - `full` string, nullable
    - `first` string, nullable
    - `last` string, nullable
  - `location` string, nullable
  - `employment` object
    - `domain` string, nullable
    - `name` string, nullable
    - `title` string, nullable
    - `role` string, nullable
    - `seniority` string, nullable
  - `social` object
    - `linkedin` string, nullable
    - `twitter` string, nullable
    - `github` string, nullable

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Insufficient credits
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error
- `502`: Upstream (provider) failure

---

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