Skip to main content
get person profile
The assistant tool is get_person_profile. Supply one canonical person_id or exact public HTTPS LinkedIn /in/ URL, without query parameters or fragments. Profiles include observed employer links, professional details, experience, education and skills. Employer match is company_id, linkedin_reference, or reported_name_only. match_basis remains: provider_company_id is company_id and provider_linkedin_reference is linkedin_reference. include: ["career_context", "activity"] bundles available reported career context and up to five cached professional posts in the one-credit profile. Transitions are conservative dated history, not newly detected job changes. Inspect data.sections, evidence, unknown source dates and coverage flags. Include work_email only on explicit contact-research intent. It runs the same actual discovery and verification as find_work_email: 2 credits only for a successful verified business-domain result on the published plan for new signups. Discovery repeats are shared between both paths. Explicitly requested employer-associated candidates may be returned as UNVERIFIED with zero email credits and independent assessment and catch-all evidence. No email or an inconclusive check adds zero email credits; a valid requested person profile still costs one. dry_run and max_credits are supported. Email outcomes.

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Recommended for every paid operation. Account-scoped and bound to normalized operation/input. Retry exactly the same key after transport loss: a committed credit result is replayed from persisted normalized bytes without a data lookup or another debit. Changed input, key expiry or paid-anchor expiry returns 409. In-flight requests return request_in_progress. Network delivery and D1 commit are not atomic. If omitted a request ID is created.

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>
Maximum string length: 2000
include
enum<string>[]
Maximum array length: 3
Available options:
work_email,
career_context,
activity
max_credits
integer

Advanced: highest number of credits this call may spend. The call is refused before any lookup when the estimate is higher.

Required range: 0 <= x <= 3
dry_run
boolean

Advanced: return the maximum credit estimate without looking up data.

Response

A settled result or a maximum estimate with no data lookup.

data
object
required
meta
object
required