Enrichment API
Find phone
Note: This endpoint is currently in beta. The API response format and behavior may change in future releases.
Overview
The Find Phone API uses Sixtyfour AI to discover phone numbers for leads. It extracts contact information from lead data and returns enriched results with phone numbers.
Endpoint
Authentication
- Required: API Key in header
- Header:
x-api-key: YOUR_API_KEY
Request Format
Request Body
Required Fields
lead
(object): Lead information object
Optional Lead Fields
name
(string): Full name of the personcompany
(string): Company namelinkedin_url
(string): LinkedIn profile URLdomain
(string): Company website domainemail
(string): Email address- Any other lead data fields
Response Format
Successful Response (200 OK)
Multiple Phones Response
No Phone Found Response
Error Responses
400 Bad Request
401 Unauthorized
429 Rate Limit Exceeded
500 Internal Server Error
Example Usage
cURL Example
Python Example
JavaScript Example
Bulk Phone Finding
Dataframe Enrichment
You can also use the bulk enrichment endpoint for processing multiple leads:
Request:
Response:
Check status with:
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:
Rate Limits
- Rate limits are applied per API key
- Check your plan for specific limits
- Use bulk processing for large datasets
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