Find Phone

Use case

Discover phone numbers for leads for sales outreach, CRM enrichment, or lead qualification.

Endpoint

POST https://api.sixtyfour.ai/find-phone

API Reference

See the full request/response schema and parameters in the API Reference.

Pricing

See Credits & Pricing Guide for credit costs.

Errors

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

Sync usage

curl -X POST "https://api.sixtyfour.ai/find-phone" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead": {
      "name": "Sarah Johnson",
      "company": "TechCorp Inc",
      "linkedin_url": "https://linkedin.com/in/sarahjohnson"
    }
  }'

import requests

response = requests.post(
    "https://api.sixtyfour.ai/find-phone",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "lead": {
            "name": "Sarah Johnson",
            "company": "TechCorp Inc",
            "linkedin_url": "https://linkedin.com/in/sarahjohnson"
        }
    }
)
response.raise_for_status()
result = response.json()

const response = await fetch("https://api.sixtyfour.ai/find-phone", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    lead: {
      name: "Sarah Johnson",
      company: "TechCorp Inc",
      linkedin_url: "https://linkedin.com/in/sarahjohnson"
    }
  })
});

const result = await response.json();

Async pattern

For production workflows, use /find-phone-async to submit a job and poll for results. This avoids long-lived HTTP connections and lets you parallelize many lookups without blocking your client. The flow is:

Submit — POST /find-phone-async with the same body as the sync endpoint. Response includes a task_id.
Poll — GET /job-status/{task_id} until status is completed, failed, or cancelled.
Read result — When completed, the discovered phone numbers are in the result field, in the same shape as the sync response.

The async start endpoint returns uppercase RUNNING. Subsequent /job-status/{task_id} calls return lowercase statuses. charge_amount is returned in cents, not credits.

Polling example

import requests
import time

response = requests.post(
    "https://api.sixtyfour.ai/find-phone-async",
    headers={"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "lead": {
            "name": "Sarah Johnson",
            "company": "TechCorp Inc",
            "linkedin_url": "https://linkedin.com/in/sarahjohnson"
        }
    }
)
response.raise_for_status()
task_id = response.json()["task_id"]

while True:
    status = requests.get(
        f"https://api.sixtyfour.ai/job-status/{task_id}",
        headers={"x-api-key": "YOUR_API_KEY"}
    ).json()

    if status["status"] == "completed":
        results = status["result"]
        break
    if status["status"] in ("failed", "cancelled"):
        raise RuntimeError(f"Job {status['status']}: {status.get('error', 'Unknown error')}")

    time.sleep(5)

async function runAsync() {
  const start = await fetch("https://api.sixtyfour.ai/find-phone-async", {
    method: "POST",
    headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({
      lead: {
        name: "Sarah Johnson",
        company: "TechCorp Inc",
        linkedin_url: "https://linkedin.com/in/sarahjohnson"
      }
    })
  });
  if (!start.ok) throw new Error(`Submit failed: ${start.status}`);
  const { task_id } = await start.json();

  while (true) {
    const pollRes = await fetch(
      `https://api.sixtyfour.ai/job-status/${task_id}`,
      { headers: { "x-api-key": "YOUR_API_KEY" } }
    );
    if (!pollRes.ok) throw new Error(`Poll failed: ${pollRes.status}`);
    const status = await pollRes.json();

    if (status.status === "completed") return status.result;
    if (["failed", "cancelled"].includes(status.status)) {
      throw new Error(`Job ${status.status}: ${status.error || "Unknown error"}`);
    }
    await new Promise(r => setTimeout(r, 5000));
  }
}

Webhook callback

Pass a webhook_url to receive the result via HTTP POST instead of polling. The signed payload, retry behavior, and verification steps are documented in Outgoing Webhooks.

POST /find-phone-async
{
  "lead": {
    "name": "Sarah Johnson",
    "company": "TechCorp Inc",
    "linkedin_url": "https://linkedin.com/in/sarahjohnson"
  },
  "webhook_url": "https://your-server.com/webhooks/sixtyfour"
}

Bulk processing

Use /find-phone-bulk (sync) or /find-phone-bulk-async (async) to process up to 100 leads in a single call. Both accept a leads array and the same providers and webhook_url fields as the single-lead endpoints.

Bulk sync

Returns 200 OK with results once every lead is processed. Best for small batches where you want a single round-trip.

curl -X POST "https://api.sixtyfour.ai/find-phone-bulk" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      {
        "name": "Sarah Johnson",
        "company": "TechCorp Inc",
        "linkedin_url": "https://linkedin.com/in/sarahjohnson"
      },
      {
        "name": "John Doe",
        "company": "Example Corp",
        "linkedin_url": "https://linkedin.com/in/johndoe"
      }
    ]
  }'

import requests

response = requests.post(
    "https://api.sixtyfour.ai/find-phone-bulk",
    headers={"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "leads": [
            {
                "name": "Sarah Johnson",
                "company": "TechCorp Inc",
                "linkedin_url": "https://linkedin.com/in/sarahjohnson"
            },
            {
                "name": "John Doe",
                "company": "Example Corp",
                "linkedin_url": "https://linkedin.com/in/johndoe"
            }
        ]
    }
)
response.raise_for_status()
results = response.json()

Bulk async

Submit a batch, get back a task_id, then poll /job-status/{task_id} (or set webhook_url to receive a callback). Recommended for batches of more than a handful of leads, or when you don’t want to hold a long-lived HTTP connection.

import requests
import time

response = requests.post(
    "https://api.sixtyfour.ai/find-phone-bulk-async",
    headers={"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "leads": [
            {
                "name": "Sarah Johnson",
                "company": "TechCorp Inc",
                "linkedin_url": "https://linkedin.com/in/sarahjohnson"
            },
            {
                "name": "John Doe",
                "company": "Example Corp",
                "linkedin_url": "https://linkedin.com/in/johndoe"
            }
        ]
    }
)
response.raise_for_status()
task_id = response.json()["task_id"]

while True:
    status = requests.get(
        f"https://api.sixtyfour.ai/job-status/{task_id}",
        headers={"x-api-key": "YOUR_API_KEY"}
    ).json()

    if status["status"] == "completed":
        results = status["result"]
        break
    if status["status"] in ("failed", "cancelled"):
        raise RuntimeError(f"Job {status['status']}: {status.get('error', 'Unknown error')}")

    time.sleep(10)

Get Started

Intelligence API

Search API

Workflows API

Webhooks

Troubleshooting

Developer Tools

Use case

Endpoint

API Reference

Pricing

Errors

Sync usage

Async pattern

Polling example

Webhook callback

Bulk processing

Bulk sync

Bulk async

​Use case

​Endpoint

API Reference

​Pricing

​Errors

​Sync usage

​Async pattern

​Polling example

​Webhook callback

​Bulk processing

​Bulk sync

​Bulk async

Use case

Endpoint

Pricing

Errors

Sync usage

Async pattern

Polling example

Webhook callback

Bulk processing

Bulk sync

Bulk async