Skip to main content
POST
Enrich an email address into a contact profile

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
email
string
required

The email address to enrich. Trimmed and lower-cased before anything else; a non-blank value that is not a well-formed address is answered reason: "invalid-input", uncharged.

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