Skip to main content
POST
Find a person's email address

Authorizations

Authorization
string
header
required

Server-side API key created in the dashboard. Send as Authorization: Bearer ak_….

Headers

Idempotency-Key
string
required

16 to 100 characters, letters, digits, underscore and hyphen only. A UUID fits. Anything outside that returns 400 idempotency_key_required_16_to_100_characters.

Retrying with the same key and the same input returns the original job instead of starting or charging a second one. The same key with a different input returns 409.

Required string length: 16 - 100
Pattern: ^[a-zA-Z0-9_-]{16,100}$

Body

application/json
name
string
required

Full name as the company would write it.

Required string length: 2 - 160
Example:

"Rachel Okafor"

domain
string
required

Bare domain, no scheme or path.

Maximum string length: 254
Example:

"example.com"

Response

Job accepted. Poll GET /api/v1/jobs/{id}.

id
string<uuid>
required
operation
enum<string>
required
Available options:
find,
verify
execution_state
enum<string>
required

Whether the work finished. complete and incomplete are terminal. incomplete means a stage did not finish and the result may be missing or partial; it is never presented as a confident negative. review means the job is parked for an operator; do not resubmit it.

Available options:
queued,
running,
complete,
incomplete,
review
billing
enum<string>
required

What happened to the reservation. Independent of execution_state.

Available options:
reserved,
charged,
released
charged_micros
integer
required

Micro-dollars captured. Zero until billing is charged.

rate_micros
integer
required

The rate reserved for this job, fixed at submission.

result
object
required

Null until the engine has answered.