> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reverse Lookup

> Find a person's name, employer and profile from an email address or phone number.

Your request returns a [Job](https://docs.sixtyfour.ai/api-reference/async-jobs.md). When a single lookup succeeds, read the profile from `result`.

> [tab] Email
>
> ## Request
>
> ```bash cURL theme={null}
> curl --fail-with-body -sS https://api.sixtyfour.ai/v1/people/contacts/reverse \
>   -H "x-api-key: YOUR_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"email":"saarth.work@example.com","wait_seconds":20}'
> ```
>
> ```python Python theme={null}
> import requests
>
> response = requests.post(
>     "https://api.sixtyfour.ai/v1/people/contacts/reverse",
>     headers={"x-api-key": "YOUR_API_KEY"},
>     json={"email": "saarth.work@example.com", "wait_seconds": 20},
> )
> response.raise_for_status()
> print(response.json())
> ```
>
> ```javascript JavaScript theme={null}
> const response = await fetch("https://api.sixtyfour.ai/v1/people/contacts/reverse", {
>   method: "POST",
>   headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
>   body: JSON.stringify({ email: "saarth.work@example.com", wait_seconds: 20 }),
> });
> if (!response.ok) throw new Error(await response.text());
> console.log(await response.json());
> ```
>
> ## Result
>
> ```json HTTP 200 theme={null}
> {
>   "job_id": "job_7c023d30-1165-4e7c-892f-37715095defb",
>   "status": "succeeded",
>   "created_at": "2026-11-13T23:10:58.081913Z",
>   "result": {
>     "email_searched": "saarth.work@example.com",
>     "email_error": "",
>     "firstname": "Saarth",
>     "lastname": "Shah",
>     "domain": "",
>     "linkedin_url": "https://www.linkedin.com/in/saarthshah",
>     "linkedin_id": "",
>     "location": "San Francisco, California, United States",
>     "headline": "",
>     "summary": "",
>     "title": "Co-Founder & CEO",
>     "position_description": "",
>     "company_name": "Sixtyfour",
>     "company_linkedin_url": "",
>     "company_domain": "sixtyfour.ai",
>     "company_website": "",
>     "company_description": "The Enterprise Data Platform to deploy AI agents that unify social, contact, and proprietary data into decision-ready profiles.",
>     "company_industry": "Research",
>     "company_headcount": "",
>     "company_headcount_range": "",
>     "company_year_founded": "",
>     "company_headquarters": ""
>   },
>   "operation": "people.contacts.reverse",
>   "counts": {
>     "total": 1,
>     "succeeded": 1,
>     "failed": 0,
>     "pending": 0
>   }
> }
> ```
>
> Email lookups use empty strings for missing values. With no match, `email_error` is `"No data found"`.
>
> ### Email lookup fields
>
> | Field | Type | Format or meaning |
> | - | - | - |
> | `email_searched` | string | Email address sent in the request. |
> | `email_error` | string | Empty on a match; otherwise the lookup error. |
> | `firstname` | string | Given name, such as `Saarth`. |
> | `lastname` | string | Family name, such as `Shah`. |
> | `location` | string | City, region and country when available. |
> | `domain` | string | `""` when unavailable. |
> | `linkedin_url` | string | Full LinkedIn profile URL. |
> | `linkedin_id` | string | LinkedIn profile identifier, when supplied by the source. |
> | `headline` | string | Profile headline, when available. |
> | `summary` | string | Profile biography, when available. |
> | `title` | string | Current job title. |
> | `position_description` | string | Description of the current role. |
> | `company_name` | string | Employer name. |
> | `company_domain` | string | Employer domain, such as `sixtyfour.ai`. |
> | `company_website` | string | Employer website URL. |
> | `company_linkedin_url` | string | Employer LinkedIn page URL. |
> | `company_description` | string | Employer description. |
> | `company_industry` | string | Employer industry. |
> | `company_headcount` | string | Employee count as text, when found. |
> | `company_headcount_range` | string | Employee range, such as `11-50`. |
> | `company_year_founded` | string | Four-digit year as text, when found. |
> | `company_headquarters` | string | Employer headquarters location. |
>
> See [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md) for more information.

> [tab] Phone
>
> ## Request
>
> ```bash cURL theme={null}
> curl --fail-with-body -sS https://api.sixtyfour.ai/v1/people/contacts/reverse \
>   -H "x-api-key: YOUR_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{"phone":"+14155550123","wait_seconds":20}'
> ```
>
> ```python Python theme={null}
> import requests
>
> response = requests.post(
>     "https://api.sixtyfour.ai/v1/people/contacts/reverse",
>     headers={"x-api-key": "YOUR_API_KEY"},
>     json={"phone": "+14155550123", "wait_seconds": 20},
> )
> response.raise_for_status()
> print(response.json())
> ```
>
> ```javascript JavaScript theme={null}
> const response = await fetch("https://api.sixtyfour.ai/v1/people/contacts/reverse", {
>   method: "POST",
>   headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
>   body: JSON.stringify({ phone: "+14155550123", wait_seconds: 20 }),
> });
> if (!response.ok) throw new Error(await response.text());
> console.log(await response.json());
> ```
>
> ## Result
>
> ```json HTTP 200 theme={null}
> {
>   "job_id": "job_53b0e67f-7587-4fb7-aacf-b81529b9e5a1",
>   "status": "succeeded",
>   "operation": "people.contacts.reverse",
>   "created_at": "2026-11-14T00:35:00Z",
>   "counts": {
>     "total": 1,
>     "succeeded": 1,
>     "failed": 0,
>     "pending": 0
>   },
>   "result": {
>     "phone_searched": "+14155550123",
>     "fullname": "Saarth Shah",
>     "firstname": "Saarth",
>     "lastname": "Shah",
>     "linkedin_url": "https://www.linkedin.com/in/saarthshah",
>     "title": "",
>     "company_name": "Sixtyfour",
>     "domain": "",
>     "location": "",
>     "email": "",
>     "phone_error": ""
>   }
> }
> ```
>
> Phone lookups use empty strings for missing values. With no match, `phone_error` is `"No data found"`.
>
> ### Phone lookup fields
>
> | Field | Type | Format or meaning |
> | - | - | - |
> | `phone_searched` | string | Phone number sent in the request, such as `+14155550123`. |
> | `phone_error` | string | Empty on a match; otherwise the lookup error. |
> | `fullname` | string | Full name, such as `Saarth Shah`. |
> | `firstname` | string | Given name. |
> | `lastname` | string | Family name. |
> | `linkedin_url` | string | Full LinkedIn profile URL. |
> | `title` | string | Current job title. |
> | `company_name` | string | Employer name. |
> | `domain` | string | Employer domain, such as `sixtyfour.ai`. |
> | `location` | string | City, region and country when available. |
> | `email` | string | Email address associated with the number, when available. |
>
> See [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md) for more information.

## Parameters

Send exactly one of `email`, `phone`, `items` or `input_file_id`.

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `email` | string | One input source | | Email address to look up. |
| `phone` | string | One input source | | Phone number with country code, such as `+14155550123`. |
| `items` | array of objects | One input source | | From 1 to 100,000 entries, each with either `email` or `phone` and an optional `custom_id`. Do not mix contact types in one request. |
| `input_file_id` | string | One input source | | Uploaded CSV, JSON, JSONL or NDJSON file with either an `email` or `phone` column. Use one contact type per file. |
| `wait_seconds` | integer | No | `5` | Seconds to wait for the Job to finish, from 0 to 20. |
| `webhook_url` | string (HTTPS) | No | | Receives a callback when the lookup finishes. See [Outgoing Webhooks](https://docs.sixtyfour.ai/api-reference/webhooks/outgoing.md). |
| `custom_id` | string | No | | Your identifier for a single lookup. For a batch, put it on each entry in `items` or each uploaded row. |

> [card] [Try it](https://docs.sixtyfour.ai/api-reference/contacts/reverse-lookup.md)
>
> Open the Reverse Lookup API Reference playground.

## Related

* [Find Contacts](https://docs.sixtyfour.ai/api-reference/endpoint/find-contacts.md)
* [Batch Processing](https://docs.sixtyfour.ai/guides/batch-processing.md)
* [Handling Errors](https://docs.sixtyfour.ai/api-reference/errors.md)

> [!NOTE]
>
> For older requests, see [Reverse Email](https://docs.sixtyfour.ai/api-reference/endpoint/reverse-email.md) and [Reverse Phone](https://docs.sixtyfour.ai/api-reference/endpoint/reverse-phone.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.