---
title: "Email Finder"
method: POST
path: "/v1/people/email-finder"
tags: ["People Enrichment"]
---

# Email Finder

`POST /v1/people/email-finder`

Find a person's work email address using their name and company information.

## Request body

- object
  - `first_name` string — First name of the person (optional if full_name provided)
  - `last_name` string, nullable — Last name of the person (optional)
  - `full_name` string, nullable — Full name of the person (alternative to first_name + last_name)
  - `domain` string — Company domain name (required if company_name not provided)
  - `company_name` string — Company name (required if domain not provided)

## Response `200`

Successful response with email details

- object
  - `email` string
  - `status` string
  - `credits_consumed` integer
  - `message` string
  - `first_name` string
  - `last_name` string
  - `domain` string
  - `mx_record` string
  - `mx_provider` string
  - `mx_security_gateway` boolean
  - `has_mx` boolean — Whether the domain has MX records
  - `mx_records_full` object[] — Complete list of MX records with priorities
    - `priority` integer
    - `exchange` string
  - `company_name` string
  - `company_industry` string
  - `company_size` string
  - `company_founded` integer
  - `company_location` object
    - `name` string
    - `locality` string
    - `region` string
    - `metro` string
    - `country` string
    - `continent` string
    - `street_address` string
    - `address_line_2` string
    - `postal_code` string
    - `geo` string
  - `company_profile_url` string
  - `company_profile_id` string
  - `company_facebook_url` string
  - `company_twitter_url` string
  - `company_type` string
  - `employment_verified` boolean, nullable — Whether the employment at the domain was verified

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `402` — Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/settings/billing
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/versions/e95809714e4d/schema)