Reverse Phone Lookup
People APIs
Reverse Phone Lookup
Find a person’s professional profile using their phone number
GET
Reverse Phone Lookup
Overview
Find a person’s professional profile using their phone number. This endpoint is useful for identifying unknown callers, enriching contact databases, and discovering professional information about phone contacts.Authentication
Your Tuesday API key
Query Parameters
Phone number to lookup (e.g.,
+14155552671, +1 713-408-6387)Format: International format with country code is recommendedResponse
HTTP status code (200 for success)
Response message
Example Requests
Example Response
Phone Number Formats
Supported Formats
Supported Formats
The API accepts various phone number formats:Recommended (International):
+1 713-408-6387+14155552671+44 20 7946 0958
(713) 408-6387713-408-63877134086387
Best Practices
Best Practices
For optimal results:
- Include country code when possible (e.g.,
+1for US) - Use international format for non-US numbers
- URL encode special characters in API requests
- Ensure numbers are complete and valid
Credit Usage
Credit per lookup
Phone reverse lookup uses 1 credit per request. Unlike other people endpoints, this doesn’t have additional enrichment options since contact information is already provided.
Error Responses
400 Bad Request - Missing Phone Number
400 Bad Request - Missing Phone Number
400 Bad Request - Invalid Phone Format
400 Bad Request - Invalid Phone Format
404 Not Found - Phone Not Found
404 Not Found - Phone Not Found
Best Practices
Phone Number Quality
Phone Number Quality
- Business/mobile numbers typically have higher match rates
- Landline numbers may have lower success rates
- Recent numbers are more likely to return current information
- Professional contact numbers yield better results than personal lines
Privacy Considerations
Privacy Considerations
- Only lookup phone numbers you have legitimate business reasons to research
- Respect privacy laws and regulations in your jurisdiction
- Consider opt-in/opt-out mechanisms for contact enrichment
- Use results responsibly for business purposes
Data Validation
Data Validation
- Verify phone numbers are properly formatted before lookup
- Handle cases where numbers may have changed or been reassigned
- Cross-reference results with other data points when possible
Use Cases
Caller Identification
Identify unknown business callers and prepare for conversations
Contact Enrichment
Add professional context to phone contacts in your database
Lead Verification
Verify legitimacy of phone-based leads and prospects
CRM Data Quality
Enhance phone contact records with professional information
Regional Considerations
United States & Canada
United States & Canada
- 10-digit numbers:
(555) 123-4567or+1-555-123-4567 - Business numbers typically have higher match rates
- Mobile numbers increasingly used for professional contact
International Numbers
International Numbers
- Always include country code:
+44 20 7946 0958 - Format varies by country - use standard international format
- Business directories may be less comprehensive in some regions
Mobile vs. Landline
Mobile vs. Landline
- Mobile numbers often have better match rates for professionals
- Business landlines may connect to multiple employees
- Consider the number type when interpreting results
Related Endpoints
- People Profile API - Get profile by LinkedIn URL
- People Lookup API - Find people by name and company
- Reverse Email Lookup - Find profile by email address
- People Search API - Advanced search with multiple filters