# Phone number enrichment API: get a direct phone for a person

> 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.

Source page: https://descovo.com/phone-number-enrichment-api
Updated: November 20, 2026

## 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:

```bash
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}}'
```

Python:

```python
import os, requests

r = requests.post(
    "https://api.descovo.com/v1/contacts/reveal",
    headers={"Authorization": f"Bearer {os.environ['DESCOVO_API_KEY']}"},
    json={
        "linkedinUrl": "https://www.linkedin.com/in/satyanadella",
        "enrichmentType": {
            "getWorkEmails": False,
            "getPersonalEmails": False,
            "getPhoneNumbers": True,
        },
    },
    timeout=120,
)
body = r.json()
print(body["data"], body["credits"]["charged"])
```

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](https://descovo.com/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.

Reverse lookup:

```bash
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.

## Next

- [Get an API key](https://descovo.com/sign-up)
- [REST reference](https://descovo.com/docs/rest)
- [Contact enrichment API: email and phone together](https://descovo.com/contact-enrichment-api)
- [Bulk reveal: 2,000 people per request](https://descovo.com/bulk-email-finder)
- [Waterfall enrichment, explained](https://descovo.com/waterfall-enrichment)
