Skip to main content

​
Use Case

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

​
Endpoint

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

​
Request

​
Headers

NameTypeRequiredDescription
x-api-keystringYesYour Sixtyfour API key
Content-TypestringYesMust be application/json

​
Body

FieldTypeRequiredDescription
leadobjectYesLead information object
The lead object can include any combination of the following fields. Provide as much data as possible for better results.
FieldTypeDescription
namestringFull name of the person
companystringCompany name
linkedin_urlstringLinkedIn profile URL
domainstringCompany website domain
emailstringEmail address
other key-value pairsstringAny additional key-value pairs you have on the lead
The lead object accepts any additional key-value pairs beyond the listed optional fields. You can pass extra context like title, location, website, etc. — essentially any data you have on the lead. The more information you provide, the better the discovery results.

​
Example Request

{
  "lead": {
    "name": "John Doe",
    "company": "Example Corp",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "domain": "example.com",
    "email": "[email protected]"
  }
}

​
Response

​
Success Response (200)

Phone numbers can be returned in different formats depending on results: Single phone number: 
{
  "name": "John Doe",
  "company": "Example Corp",
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "phone": "+1 555-123-4567"
}
Multiple phone numbers: 
{
  "name": "John Doe",
  "company": "Example Corp",
  "phone": [
    {
      "number": "+1 555-123-4567",
      "region": "US"
    },
    {
      "number": "+1 555-987-6543",
      "region": "US"
    }
  ]
}
No phone found: 
{
  "name": "John Doe",
  "company": "Example Corp",
  "phone": ""
}

​
Error Response (400)

{
  "detail": "Lead data is required"
}

​
Bulk Phone Finding

Use the bulk enrichment endpoint to process multiple leads at once: 
POST https://api.sixtyfour.ai/enrich-dataframe

{
  "csv_data": "name,company,linkedin_url\nJohn Doe,Example Corp,https://linkedin.com/in/johndoe\nJane Smith,Tech Inc,https://linkedin.com/in/janesmith",
  "enrichment_type": "phone"
}
Check status with GET /job-status/{job_id}.

​
Example Usage

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

​
Best Practices

​
1. Provide Rich Lead Data

Include as much information as possible for better results:
  • Full name (required for Sixtyfour AI)
  • Company name and domain
  • LinkedIn URL
  • Any existing contact information

​
2. Handle Different Response Formats

Phone numbers can be returned as:
  • String: "+1 555-123-4567"
  • Object array: [{"number": "+1 555-123-4567", "region": "US"}]
  • Empty string: "" (when no phone found)

​
3. Error Handling

Always implement proper error handling: 
try:
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status()
    result = response.json()

    phone = result.get('phone', '')
    if phone:
        print(f"Phone found: {phone}")
    else:
        print("No phone number found")

except requests.exceptions.RequestException as e:
    print(f"API request failed: {e}")

​
Setup Requirements

  • SIXTYFOUR_API_KEY environment variable must be set
  • Valid Sixtyfour AI subscription with phone enrichment access

​
Phone Number Formats

  • International format preferred: +1 555-123-4567
  • Regional codes included when available
  • Multiple numbers returned as array when found

​
Limitations

  • Requires first name and last name for Sixtyfour AI processing
  • Sixtyfour AI API timeout: 3 minutes maximum
  • Phone availability depends on Sixtyfour AI’s database coverage
  • Some regions may have limited phone number availability