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,
    "source": "satellyte"
  }
}

Response (200): not found

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

Response fields

Field	Type	Notes
`email`	string	Resolved email; empty string when not found.
`verified`	boolean	Whether the email passed verification.
`confidence`	number	0.0 to 1.0. 0 when not found.
`source`	string \| null	Opaque source label. Do not branch on specific values.

Errors

400 validation_error: none of linkedin_url or (name + company) provided.
402 insufficient_credits: workspace is out of email enrichment credits.