---
title: "Reverse Email Endpoint"
method: POST
path: "/enrich/reverse-email"
tags: ["enrichment"]
---

# Reverse Email Endpoint

`POST /enrich/reverse-email`

## Request

- Base URL: `https://api.dataforb2b.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dataforb2b.ai/enrich/reverse-email`
- Auth: none declared

Resolve a professional email address into its LinkedIn profile.

Flow:
1. The email domain is resolved to exactly one company (same domain
   matching as `/companies` search — no re-index needed for www./path
   variants).
2. If the local-part cleanly splits into two name tokens
   (`firstname.lastname` or `lastname.firstname`) and exactly one person
   at that company matches either order, the match is deterministic - no
   model involved.
3. Otherwise (single token, initials, ambiguous split) a small candidate
   pool is pulled by first name and a lightweight LLM confirms which
   candidate the email belongs to, or that none of them do.

Returns the same profile shape as `/enrich/profile`. 404 if no company or
no confirmed profile match could be found.

## Headers

- `api-key` string, nullable

## Request body

- ReverseEmailRequest: Resolve a professional email address into the matching LinkedIn profile.
  - `email` string, required: Professional email address, e.g. jane.doe@acme.com

## Response `200`

Successful Response

- ReverseEmailResponse: Same profile shape as /enrich/profile. `match_method` tells you whether the match was deterministic (name pattern + a single exact company match on the domain - no model involved) or confirmed by a small LLM because the email's local-part didn't cleanly split into firstname/lastname.
  - `profile` object, nullable: Matched LinkedIn profile (same format as /enrich/profile)
  - `match_method` string, nullable: 'deterministic' (name pattern + exact company match) or 'llm_validated'
  - `credits_used` number: Credits charged for this request

## Other responses

- `422`: Validation Error

---

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