> ## 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.

# Find Contacts

> Find a person's work email, personal email and phone number from their name, company or LinkedIn profile.

Have an email or phone and need the person? Use [Reverse Lookup](https://docs.sixtyfour.ai/api-reference/endpoint/reverse-lookup.md).

## Request

```bash cURL theme={null}
API=https://api.sixtyfour.ai
curl --fail-with-body -sS "$API/v1/people/contacts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "person": {
    "name": "Saarth Shah",
    "company": "Sixtyfour"
  },
  "find": [
    "work_email",
    "personal_email",
    "phone"
  ],
  "wait_seconds": 20
}'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.sixtyfour.ai/v1/people/contacts",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "person": {"name": "Saarth Shah", "company": "Sixtyfour"},
        "find": ["work_email", "personal_email", "phone"],
        "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", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    person: { name: "Saarth Shah", company: "Sixtyfour" },
    find: ["work_email", "personal_email", "phone"],
    wait_seconds: 20,
  }),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());
```

## Response

Your request returns a [Job](https://docs.sixtyfour.ai/api-reference/async-jobs.md). When a single-person Job reaches `succeeded`, read its contact details from `result`.

> [tab] Finished (200)
>
> ```json theme={null}
> {
>   "job_id": "job_e07337e2-0bc0-49b6-9866-2615ef5a8695",
>   "status": "succeeded",
>   "created_at": "2026-11-14T00:33:01.841272Z",
>   "result": {
>     "name": "Saarth Shah",
>     "company": "Sixtyfour",
>     "email": "saarth.work@example.com",
>     "email_status": "OK",
>     "email_type": "COMPANY",
>     "other_emails": [],
>     "personal_email": "saarth@example.com",
>     "personal_email_status": "OK",
>     "personal_email_type": "PERSONAL",
>     "personal_other_emails": [],
>     "phone": "+14155550123"
>   },
>   "operation": "people.contacts",
>   "counts": {
>     "total": 1,
>     "succeeded": 1,
>     "failed": 0,
>     "pending": 0
>   }
> }
> ```

> [tab] Running (202)
>
> ```json theme={null}
> {
>   "job_id": "job_9954325a-da11-43f2-a2ee-e67296cd9506",
>   "status": "running",
>   "created_at": "2026-11-13T22:41:20.414639Z",
>   "next_poll_after": 5,
>   "operation": "people.contacts",
>   "counts": {
>     "total": 1,
>     "succeeded": 0,
>     "failed": 0,
>     "pending": 1
>   }
> }
> ```

**result** `object`

Contact details on a finished single-person Job.

**Contact fields**

**email** `string`

Work email. Empty if the lookup finds no address.

**email\_status** `string`

Work email verification status.

**email\_type** `string`

Address category, such as `COMPANY`.

**other\_emails** `object[]`

Other work addresses, as objects with `email` and `status`.

**personal\_email** `string`

Personal email. Empty if the lookup finds no address.

**personal\_email\_status** `string`

Personal email verification status.

**personal\_email\_type** `string`

Address category, such as `PERSONAL`.

**personal\_other\_emails** `object[]`

Other personal addresses, as objects with `email` and `status`.

**phone** `string`

Phone number with country code, such as `+14155550123`. Empty if the lookup finds no number.

| Email status | Meaning |
| - | - |
| `OK` | Verified. Safe to send. |
| `RISKY` | The domain accepts all mail, so the address can't be confirmed. |
| `INVALID` | The address will bounce. |
| `UNKNOWN` | Not verified, or verification could not finish. |
| `NOT_FOUND` | No address was found. |

Contacts uses uppercase email statuses. [Verify Email](https://docs.sixtyfour.ai/api-reference/endpoint/verify-email.md) returns lowercase `valid`, `risky`, `invalid` or `unknown`.

## Parameters

Send exactly one of `person`, `people` or `input_file_id`.

**person** `object`

Person to look up. Accepts a name, company, LinkedIn URL and other known fields.

**people** `object[]`

People to look up. From 1 to 100,000 records.

**input\_file\_id** `string`

Uploaded file of people.

**find** `string[]` *required*

One to three unique [contact types](#contact-types).

**verify\_emails** `boolean` (default: true)

If true, verifies found addresses. If false, returns the first address with status `UNKNOWN`. Does not affect phones.

**wait\_seconds** `integer` (default: 5)

Seconds to wait for the Job to finish, from 0 to 20.

**webhook\_url** `string`

HTTPS callback URL.

Records accept a `custom_id` to match each result to your records.

### Contact types

| `find` value | What it finds |
| - | - |
| `work_email` | A work email at the person's company. |
| `personal_email` | A personal email, returned in `personal_email`. |
| `phone` | A phone number. |

See [Credit Costs](https://docs.sixtyfour.ai/guides/credits-and-pricing.md) for more information.

> [card] [Try it](https://docs.sixtyfour.ai/api-reference/contacts/find-contacts.md)
>
> Open the Find Contacts API Reference playground.

## Related

* [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 [Find Email](https://docs.sixtyfour.ai/api-reference/endpoint/find-email.md) and [Find Phone](https://docs.sixtyfour.ai/api-reference/endpoint/find-phone.md).


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