Enrich Email

Find or verify an email from a LinkedIn URL or a name + company.

Costs 1 credit. A credit is deducted only when an email is successfully returned. Lookups that find no match cost nothing.

Tip: Prefer linkedin_url when you have it. It produces the highest match rate. Fall back to name plus company for contacts you discovered outside LinkedIn.

Endpoint

POST /api/v1/enrich/email

Authentication

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

Request body

Field	Type	Required	Notes
`linkedin_url`	string	Conditional	LinkedIn profile URL. Required if `name` + `company` are not provided.
`name`	string	Conditional	Full name. Used with `company`.
`company`	string	Conditional	Company name or domain. Used with `name`.

At least one of these combinations must be provided: linkedin_url, or both name and company.

cURL: by LinkedIn URL

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

cURL: by name + company

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/enrich/email" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Sam Altman", "company": "OpenAI" }'

Response (200): found

{
  "data": {
    "email": "jane@example.com",
    "verified": true,
    "confidence": 0.9
  }
}

Response (200): not found

{
  "data": {
    "email": "",
    "verified": false,
    "confidence": 0
  }
}

Response fields

Field	Type	Notes
`data.email`	string	Email address returned when one is found or verified.
`data.verified`	boolean	Whether the email is verified.
`data.confidence`	number	Confidence score from `0` to `1`.

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 URL is invalid, or the required name/company inputs are missing or invalid.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when no email can be found or verified for the provided inputs.
`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.