---
title: "Resolve a business email"
method: POST
path: "/api/v1/reverse-email"
tags: ["Resolution"]
---

# Resolve a business email

`POST /api/v1/reverse-email`

## Request

- Base URL: `https://targetwise.ai`
- URL: `https://targetwise.ai/api/v1/reverse-email`
- Auth: HTTP bearer

Resolves one permitted business email into available professional identity, role and company context. This is identity enrichment, not mailbox deliverability or SMTP verification.

## Request body

- object
  - `email` string, email, required
  - `include_phone` boolean
  - `include_profile` boolean: Request available location, headline, work history, education and skills. Account permission may be required.

## Response `200`

A normalized match, partial match or no-match result.

- object
  - `object` 'enrichment_result', required
  - `operation` 'reverse_email_lookup', required
  - `request_id` string, required
  - `status` 'matched' | 'partial' | 'not_found', required
  - `data` object, nullable, required
    - `person_id` string
    - `full_name` string
    - `first_name` string
    - `last_name` string
    - `headline` string: Professional headline, returned when include_profile is true and the field is available.
    - `role` string
    - `seniority` string[]
    - `departments` string[]
    - `work_email` string, email
    - `business_phone` string
    - `phone_type` 'unknown': The source returns a generic phone field without classifying it as mobile or landline.
    - `linkedin_url` string, uri
    - `location` string: Professional location, such as city, region and country; requires include_profile.
    - `country` string
    - `company_id` string
    - `company_name` string
    - `company_website` string
    - `company_linkedin_url` string
    - `work_experience` object[]: Available employment history when include_profile is true.
      - `company_name` string
      - `title` string
      - `location` string
      - `description` string
      - `started_on` string: Reported start date; may contain only a year or month and year.
      - `ended_on` string, nullable: Reported end date. An explicit null identifies a current role; an omitted value is unknown.
      - `is_current` boolean: Returned when the source explicitly identifies a current or past role.
    - `education` object[]: Available institutions, studies and dates when include_profile is true.
      - `institution_name` string
      - `study` string: Reported course or qualification, preserved without inferring a separate degree or subject.
      - `degree` string
      - `field_of_study` string
      - `started_on` string
      - `ended_on` string, nullable
    - `skills` string[]: Reported professional skills when include_profile is true.
  - `unresolved_fields` string[], required
  - `grounding` object, required
    - `retrieved_at` string, date-time, required
    - `source_provenance` 'included' | 'not_available', required

## Other responses

- `400`: Invalid request or operation_pricing_unavailable. Adding credit does not enable an unpriced operation.
- `401`: A valid TargetWise bearer key is required.
- `402`: Free allowance or paid balance exhausted, or usage_budget_reached. A top-up does not increase the monthly usage budget.
- `403`: The workspace is inactive or access is restricted.
- `409`: Workspace usage could not be reserved. Inspect retryable before a bounded retry.
- `413`: The request body exceeds 64 KB.
- `415`: Use Content-Type: application/json.
- `429`: The workspace attempt/rate limit or provider limit has been reached.
- `500`: Unexpected internal error.
- `502`: The data connection returned an unusable response.
- `503`: The service or data connection is unavailable or unconfigured.
- `504`: The data connection timed out.

---

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