Skip to main content
Get person
Supply exactly one returned person_id or public HTTPS LinkedIn /in/ profile URL. URLs must not include query parameters or fragments. Set include to ["work_email"] only when contact information is needed. A valid person lookup counts even if no email is available or verification is inconclusive. Read work-email statuses and usage and retries.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer dl_live_<64 lowercase hexadecimal characters>. Approved users can create account-scoped, revocable keys in the Datalayer dashboard. A key does not grant a profile allowance. Dashboard session cookies are not API credentials.

Headers

Idempotency-Key
string

Recommended for lookup retries. A key is scoped to this account and bound to the normalized operation/input. Reuse it only for the same request within 24 hours; changed input, an expired key, or a different resolved profile returns 409. A replay refetches data but deducts no additional profile. If omitted, the server creates a request ID. A network failure after database commit starts can leave a completed deduction; a timeout alone does not imply zero usage.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json
person_id
string
required
Pattern: ^[1-9][0-9]{0,19}$
profile_url
string<uri>

Public LinkedIn profile URL under /in/, without credentials, a query, fragment, or non-default port.

include
string[]

Optional work_email requests return per-address verification status; no separate email price.

Maximum array length: 1
Allowed value: "work_email"

Response

Normalized data with current shared account usage metadata.

data
object
required

Normalized search results or profile. Search results are previews. Full profile fields may be null when unavailable.

meta
object
required