Skip to main content
The Reveal Phone endpoint returns phone numbers for contacts in Clodura’s database. You identify a person using their personId or LinkedIn profile URL, set revealPhoneNumberViaPartners to true to enable multi-provider enrichment, and provide a webhookUrl to receive the result once processing completes. Clodura handles all provider orchestration on your behalf — you do not need separate accounts or API keys with third-party data sources. Just like the email endpoint, the response schema varies by your Clodura plan:
  • Prospect & Prospect Pro plans — receive the Standard Webhook Response with phone numbers sourced directly from Clodura’s database.
  • Free Forever, Max, and PAYG plans — receive the Multi-Provider Response, aggregating results from Clodura, SignalHire, Enrichlayer, Wiza, LeadMagic, RocketReach, Findymail, and more.
Credit cost (Prospect/Prospect Pro): 1 phone credit + 1 export credit when a number is found and shared. No credits are deducted if no number is found.Credit cost (Free Forever, Max, PAYG): 10–20 credits when a phone number is successfully retrieved. The exact cost depends on which provider locates the number. No credits are charged if no number is found across all providers.
LinkedIn Sales Navigator URLs are not supported. Always supply standard linkedin.com/in/ profile URLs.

​
Endpoint

POST /api/v1/search/people/phone/match

​
Request

​
Headers

HeaderValue
X-API-KEYYour Clodura API key
Content-Typeapplication/json

​
Body Parameters

You must supply either personId or linkedinUrl.
​
personId
string
Clodura’s unique identifier for the person. Obtain this from the Search Prospect endpoint.
​
linkedinUrl
string
Standard LinkedIn profile URL for the person (e.g., https://www.linkedin.com/in/kapilkhangaonkar/). Sales Navigator URLs are not supported.
​
revealPhoneNumberViaPartners
boolean
When true, Clodura queries integrated partner providers for additional phone numbers if the primary database has no result. Requires webhookUrl to be set. Defaults to false.
​
webhookUrl
string
required
The URL where Clodura will POST the final JSON result once phone verification and partner enrichment complete. Required when revealPhoneNumberViaPartners is true.

​
Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/search/people/phone/match \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "linkedinUrl": "https://www.linkedin.com/in/brad-dickey-72b846a",
    "revealPhoneNumberViaPartners": true,
    "webhookUrl": "https://webhook.site/your-unique-id"
  }'

​
Response

​
Immediate API Response (200)

​
trackingId
string
A unique identifier for this enrichment job. Use this with GET /api/v1/search/people/track/{trackingId} to poll for the result if your webhook does not receive the callback.
​
status
string
Confirmation that the job has been queued for processing.
{
  "trackingId": "688a0c47e21f6bc2b089ee19",
  "status": "Callback will be triggered once processing is complete."
}

​
Webhook Payload — Standard (Prospect & Prospect Pro Plans)

​
personId
string
Clodura’s unique identifier for the matched contact.
​
firstName
string
The contact’s first name.
​
lastName
string
The contact’s last name.
​
phoneNumbers
array
{
  "personId": "2751275603503088159",
  "firstName": "Brad",
  "lastName": "Dickey",
  "phoneNumbers": [
    {
      "raw_number": "+11099773515",
      "type": "mobile",
      "source": "partner"
    }
  ]
}

​
Webhook Payload — Multi-Provider (Free Forever, Max & PAYG Plans)

​
trackingId
string
The tracking ID matching the one returned in the immediate API response.
​
people
array
​
status
string
Final status of the enrichment job: success.
{
  "trackingId": "69c25b4178ded0e4ebfc4772",
  "people": [
    {
      "personId": "3602687943191298570",
      "firstName": "Brad",
      "lastName": "Dickey",
      "phoneNumbers": {
        "Clodura": { "status": "notFound" },
        "SignalHire": { "status": "notFound" },
        "Enrichlayer": { "status": "notFound" },
        "Wiza": { "status": "notFound" },
        "LeadMagic": { "status": "notFound" },
        "RocketReach": { "status": "notFound" },
        "Findymail": {
          "mobile": ["+1439-570-0805"],
          "status": "found"
        }
      }
    }
  ],
  "status": "success"
}

​
Provider Status Definitions

StatusDescription
foundThe provider retrieved one or more phone numbers for this contact.
notFoundThe provider could not locate any phone data for this contact.
Insufficient CreditsYour Clodura credits are exhausted; no further provider calls can be made.

​
Error Codes

StatusMeaning
400Bad request — check request body for missing or invalid fields
401Unauthorized — your API key is missing or invalid
402Payment required — credits exhausted; upgrade your plan or add credits
403Forbidden — this endpoint requires a paid Clodura plan, or the request is missing required details
404No result found — no phone number could be located
422Unprocessable entity — invalid or incomplete request body
429Rate limit exceeded — reduce request frequency or upgrade your plan