Skip to main content
POST
Enrich a person

Authorizations

Authorization
string
header
required

Pass your API key as a bearer token: Authorization: Bearer YOUR_API_KEY. Generate and manage keys from your dashboard under Settings → API Keys.

Headers

Idempotency-Key
string

Reusing the same key returns the original task instead of creating and charging a new one. Use it to retry a request whose response you never received.

A key is bound to the body it was first sent with. Reusing it with a different body is rejected with 422. Maximum 255 characters.

Maximum string length: 255

Body

application/json
linkedinUrl
string

A LinkedIn profile URL, e.g. "https://www.linkedin.com/in/jane-doe".

Example:

"https://www.linkedin.com/in/jane-doe"

email
string

A work email address, as an alternative to linkedinUrl. Resolved live against LinkedIn. See the endpoint description for what happens on a miss or a tie.

Example:

"jane.doe@acme.com"

fullName
string

Optional hint for email lookups only. Read solely to break a tie after an ambiguous result. Never used as a search filter. Rejected alongside linkedinUrl.

Maximum string length: 200
Example:

"Jane Marie Doe"

title
string

Optional tie-break hint for email lookups. The person's job title.

Maximum string length: 200
Example:

"Head of Finance"

location
string

Optional tie-break hint for email lookups. A city or country.

Maximum string length: 200
Example:

"Amsterdam"

loop_id
string<uuid>

Deliver the result to this Loop's webhook once it's ready, in addition to polling this task directly.

Response

The task settled inside the request (a record we already hold, or an idempotent replay).

Never carries data. Carries error only if the task already failed inside the request. Fetch the result from GET /v1/tasks/{id} or a Loop webhook.

task
object
required

input and target are dropped in future revisions to a single field; today target is the normalized domain or LinkedIn URL the task resolved to.

error
object