Back to APIs

Unified Agent API

Phone Finder

Phone Finder

Find a named professional's direct number from Forager's strictest-verified phone data, with FullEnrich's waterfall of 20+ contact-data providers behind it.

POST/v1/phones/findVerified numbers

Overview

Find a person's direct phone numbers

Credits

30 credits per call

Providers

ForagerFullEnrich

SDK Method

client.phones.find(...)

Parameters

linkedin_url

string

LinkedIn profile URL.

first_name

string

First name.

last_name

string

Last name.

domain

string

Company domain.

company

string

Company name.

Example Response

{
  "success": true,
  "data": {
    "phone": "+33676789065",
    "line_type": "mobile",
    "country": "FR",
    "mobile": true,
    "phones": [
      {
        "number": "+33676789065",
        "display": "+33 6 76 78 90 65",
        "line_type": "mobile",
        "country": "FR",
        "line_status": "active"
      },
      {
        "number": "+33184800000",
        "display": "+33 1 84 80 00 00",
        "line_type": "landline",
        "country": "FR",
        "line_status": "active"
      }
    ],
    "first_name": "Jane",
    "last_name": "Smith",
    "domain": "acme.com",
    "linkedin_url": "https://www.linkedin.com/in/janesmith"
  },
  "metadata": {
    "provider_used": "fullenrich",
    "providers_tried": [
      "fullenrich"
    ],
    "mode_used": null,
    "response_time_ms": 56210,
    "request_id": "req_5b81c2d0"
  },
  "credits_used": 87
}

Get Started

Create a Suprsonic API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Phone Finder

Test Phone Finder in the interactive playground. No setup required.

Open Playground