Reverse Phone - Sixtyfour AI Documentation

Send a phone number and get back the person behind it: name, location, email, employer and LinkedIn profile.

curl -X POST "https://api.sixtyfour.ai/reverse-phone" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lead": { "phone": "+14155550123" } }'

import requests

response = requests.post(
    "https://api.sixtyfour.ai/reverse-phone",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"lead": {"phone": "+14155550123"}},
)
response.raise_for_status()
lead = response.json()

const response = await fetch("https://api.sixtyfour.ai/reverse-phone", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ lead: { phone: "+14155550123" } }),
});
if (!response.ok) throw new Error(await response.text());
const lead = await response.json();

Response

{
  "phone": "+14155550123",
  "reverse_phone_error": null,
  "reverse_fullname": "Jane Doe",
  "reverse_location": "San Francisco, CA",
  "reverse_email": "jane.doe@example.com",
  "reverse_title": "Head of Sales",
  "reverse_company_name": "Example Corp",
  "reverse_linkedin_url": "https://www.linkedin.com/in/janedoe",
  "cost_cents": 30,
  "cost_credits": 3
}

Request

Field	Type	Description
`lead`	object	Required. The lead to look up, with a `phone`. Other fields come back unchanged.
`webhook_url`	string	Async only. HTTPS URL that receives the result. See Outgoing Webhooks.

Response

The lead comes back with the fields you sent plus every reverse_* field below. Fields with no match are null. cost_credits is what the request charged; cost_cents is the legacy field.

Field	Description
`reverse_phone_error`	`No data found` when no person matched, otherwise `null`.
`reverse_fullname`, `reverse_firstname`, `reverse_lastname`	Name.
`reverse_age`, `reverse_location`, `reverse_address`	Details from public records.
`reverse_relatives`, `reverse_associates`	People linked to the number in public records.
`reverse_email`	An email address for the person.
`reverse_linkedin_url`, `reverse_title`	LinkedIn profile and role.
`reverse_company_name`, `reverse_domain`	Employer and its domain.
`reverse_phone_searched`	The number looked up.

Async and bulk

Endpoint	Body	Returns
`POST /reverse-phone`	`lead`	The lead
`POST /reverse-phone-async`	`lead`	A `task_id`
`POST /reverse-phone-bulk`	`leads`, 1 to 100	`{ leads, total_leads, successful_lookups, cost_cents, cost_credits }`
`POST /reverse-phone-bulk-async`	`leads`, 1 to 100	A `task_id`

Poll async jobs with GET /job-status/{task_id}, as shown in the quick start. See Credits & Pricing for costs.

Errors

For error responses (400, 403, 422, etc.), see Handling Errors.