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

Response (200): not found

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

Response fields

Field	Type	Notes
`data.phone`	string	Mobile phone number when found. Returns an empty string when no phone number is found.
`data.valid`	boolean	Whether the returned phone number is valid.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when the request body is invalid, the LinkedIn profile URL is missing, or the LinkedIn profile URL format is not valid.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the requested Public API resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when the service cannot complete the request. Retry with backoff.