Enrich Phone

Find a mobile phone number from a LinkedIn profile URL.

Costs 10 credits. Credits are deducted only when a phone number is successfully returned.

Endpoint

POST /api/v1/enrich/phone

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Request body

Field	Type	Required	Notes
`linkedin_url`	string	Yes	LinkedIn profile URL for the person.

cURL

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/enrich/phone" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "linkedin_url": "https://www.linkedin.com/in/example/" }'

Response (200): found

{
  "data": {
    "phone": "+14155550123",
    "valid": true,
    "source": "satellyte"
  }
}

Response (200): not found

{
  "data": {
    "phone": "",
    "valid": false,
    "source": null
  }
}

Response fields

Field	Type	Notes
`phone`	string	E.164 phone; empty string when not found.
`valid`	boolean	Whether the number passed validation.
`source`	string \| null	Opaque source label.

Errors

400 validation_error: linkedin_url missing.
402 insufficient_credits: workspace is out of phone enrichment credits.