Find Mobile Number

Give it a LinkedIn profile URL and get back the person’s mobile phone number.

Endpoint: POST /v1/api/enrich/mobile
Cost: 10 credits per number found
Required input: linkedin_url
Returns: Mobile phone number

What it does

Runs waterfall enrichment across several phone providers and stops at the first that returns a number.
Returns one number — the best match. When a provider has several, the first is the one returned.
Charges 10 credits only when a number is found. A miss is free.
Is the slowest of the four lookups. Give your HTTP client a 60-second-plus timeout.

Same lookup as the find_mobile_number MCP tool.

Request body

Field	Type	Required	Notes
`linkedin_url`	string	Yes	Full LinkedIn profile URL. Max 2048 characters.
`first_name`	string	No	Raises the hit rate on sparse profiles. Max 256.
`last_name`	string	No	Raises the hit rate on sparse profiles. Max 256.
`organization_name`	string	No	Disambiguates common names. Max 256.

Examples

cURL


curl https://api.syncgtm.com/v1/api/enrich/mobile \
  --max-time 90 \
  -H "Authorization: Bearer $SYNCGTM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-contact-48213-mobile" \
  -d '{"linkedin_url": "https://www.linkedin.com/in/janedoe"}'

Node.js


const res = await fetch("https://api.syncgtm.com/v1/api/enrich/mobile", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SYNCGTM_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "crm-contact-48213-mobile",
  },
  body: JSON.stringify({ linkedin_url: "https://www.linkedin.com/in/janedoe" }),
  signal: AbortSignal.timeout(90_000),
});
 
const { status, data } = await res.json();
if (status === "found") console.log(data.phone);

Python


import os
import requests
 
res = requests.post(
    "https://api.syncgtm.com/v1/api/enrich/mobile",
    headers={
        "Authorization": f"Bearer {os.environ['SYNCGTM_API_KEY']}",
        "Idempotency-Key": "crm-contact-48213-mobile",
    },
    json={"linkedin_url": "https://www.linkedin.com/in/janedoe"},
    timeout=90,
)
res.raise_for_status()
body = res.json()
if body["status"] == "found":
    print(body["data"]["phone"])

Response


{ "status": "found", "data": { "phone": "+14155550123" } }


{ "status": "not_found", "data": null }

Field	Type	Notes
`status`	string	`found` or `not_found`
`data.phone`	string	One mobile number. Present only when `status` is `found`.

Tips

Always send an Idempotency-Key. This is the most expensive lookup and the one most likely to hit a client timeout. With a key, a retry after a dropped connection returns the original answer instead of charging another 10 credits.
Spend it on the short list. Find and verify emails for the whole list; pull mobiles only for the accounts you will actually call.
Check consent rules before you dial. Calling and texting mobile numbers is regulated in many countries.

Already have a number and only want to know if it is on WhatsApp? Use the MCP tool validate_whatsapp — 1 credit.

Errors

Status	`code`	Typical cause
400	`invalid_request`	`linkedin_url` missing or empty
402	`insufficient_credits`	Balance below 10 credits
504	`timeout`	Lookup ran past the server deadline — refunded; retry

All codes are on the Errors page.

Endpoint	Use it instead when
`work-email`	Email is enough — 1 credit
`personal-email`	You want a personal channel without a phone call — 3 credits