// PHONE NUMBER ENRICHMENT API
Phone number enrichment API: get a direct phone for a person
Updated November 20, 2026
A phone number enrichment API returns a direct phone number for a person you identify. Descovo's takes a LinkedIn profile URL and returns the number with its type, over REST or MCP. A direct phone costs 3 credits on Standard reveal, charged only when one is found, and nothing when it is not.
One request returns a person's direct phone
Post the profile URL to https://api.descovo.com/v1/contacts/reveal with getPhoneNumbers set to true. Leave the email fields false if you only need the phone, so you are only charged for the phone.
curl -X POST https://api.descovo.com/v1/contacts/reveal \
-H "Authorization: Bearer $DESCOVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"linkedinUrl":"https://www.linkedin.com/in/satyanadella","enrichmentType":{"getWorkEmails":false,"getPersonalEmails":false,"getPhoneNumbers":true}}'Each number comes back with a type, so your code can tell a mobile from another kind of line. The response also reports the cost of the call in credits.charged; when no phone is found, that is zero.
What a phone number costs
| Mode | Direct phone | Phone and work email | Use it when |
|---|---|---|---|
| Lite | 1 credit | 2 credits | Cost matters more than coverage |
| Standard | 3 credits | 5 credits | The default |
| Turbo | 5 credits | 8 credits | Speed matters, or Standard found nothing |
A reveal is charged only for the fields it finds: 2 credits for a work email, 3 for a direct phone, nothing when nothing is found.
Ask for both and you pay for both: 5 credits when a work email and direct phone come back together.
Because a miss is free, your phone budget is the number of phones found, not the number of people tried. A 5,000-credit month covers 1,666 direct phones found on Standard reveal.
Why phones cost more than emails
A direct phone is harder to find than a work email, so it is priced higher: 3 credits against 2 on Standard reveal. Standard and Turbo reveals check several data sources in sequence for the same person, an approach usually called waterfall enrichment; Lite is a shallower, cheaper lookup.
Lite uses a lower-yield lookup. Standard balances speed and coverage. Turbo prioritizes speed and uses a premium enrichment stack at a higher cost.
Phone numbers for a whole list
Send up to 2,000 profile URLs in one request with getPhoneNumbers set to true in enrichmentTypes. Credits are taken when you submit and anything not found is refunded when the job finishes. The request and polling loop are on the bulk email finder page; the same endpoint returns phones.
Going the other way: who owns this number?
https://api.descovo.com/v1/lookup/phone takes a phone number and returns the person or company behind it. It costs 3 credits when a match is found and nothing when it is not.
curl -X POST https://api.descovo.com/v1/lookup/phone \
-H "Authorization: Bearer $DESCOVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phoneNumber":"+14155550100"}'What a phone number enrichment API will not do
- It will not find a phone for everyone. Fewer people have a findable direct phone than a findable work email, and misses are free.
- It will not tell you whether you may call a number. Consent, do-not-call lists and calling-hour rules depend on where the person is, and checking them stays with you.
- It will not return people who have asked to be removed. Those requests are not charged.
- It will not place the call or send the text. Descovo returns data only.
Frequently asked questions
- What is a phone number enrichment API?
- An API that takes an identifier for a person, such as a LinkedIn profile URL, and returns a phone number for them, usually a direct or mobile line rather than a company switchboard.
- How much does a phone number cost with Descovo?
- 3 credits per direct phone found on Standard reveal, or 5 when a work email is found with it. Plans start free with 500 credits, then $99 a month for 5,000 credits.
- Do I pay when no phone number is found?
- No. A reveal that finds nothing costs nothing.
- Can I get phone numbers in bulk?
- Yes. The bulk reveal endpoint accepts up to 2,000 LinkedIn profile URLs per request and returns each person's direct phone when found. Anything not found is refunded when the job finishes.
- How many phone numbers can I look up for free?
- A new account starts with 500 credits, enough for 166 direct phones found on Standard reveal.
- Can I look up who a phone number belongs to?
- Yes. The reverse phone lookup route returns the person or company behind a number for 3 credits, charged only when a match is found.
TRY IT
Look up your first direct phone.
A new account starts with 500 credits and no card. That is enough for 166 direct phones found.