Skip to main content
POST
Find and verify contact data

Authorizations

Authorization
string
header
required

Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.

Headers

Idempotency-Key
string

Optional, 1–255 printable ASCII characters, scoped to your workspace. Send the same key when you retry the same request: the original outcome is replayed (replay: true, charged: false, pointsCharged: 0) instead of running and charging again. The same key with a different request is refused with 409 idempotency_conflict, as is a key reused after its replay record expired (kept 30 days); a key whose first request is still running answers 409 idempotency_in_progress. Without a key, every request is a new lookup, billed at most once on its own.

Required string length: 1 - 255

Body

application/json
mode
enum<string>

Lookup mode. email (default, also used for an unrecognised value): find a verified work email from a name and the company domain. company: resolve a company NAME to its domain, then find a verified work email there. linkedin: find a verified work email from a LinkedIn profile URL.

Available options:
email,
company,
linkedin
name
string

Full name of the person. Required for email and company modes.

company
string

Required for email and company modes. email mode: the company domain or website URL (reduced to its bare host). company mode: the company name.

url
string

LinkedIn profile URL. Required for linkedin mode.

Response

Every outcome, including refusals — inspect found, reason, charged and replay. A refusal is a 200 with found: false and a reason.

data
object
required