Look up a person · standard

Return standard person data from Sales Navigator search, without visiting the profile.

POST /v1/actions/salesnavigator-search-person/run/live

Authentication and cost

Use an API key in the Bearer header. This action costs 1 credit per returned record. The maximum result count is 1.

Request

bash

curl "$API_URL/v1/actions/salesnavigator-search-person/run/live" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: unique-salesnavigator-search-person-001" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "first_name": "Satya",
    "last_name": "Nadella",
    "company": "Microsoft"
  },
  "max_results": 1,
  "max_credits": 1
}'

Parameter	Requirement
`input.first_name`	Required non-empty string, at most 100 characters.
`max_results`	Integer from 1 to 1. Default 1.
`max_credits`	Optional positive integer; must cover the requested reservation.
`Idempotency-Key`	Required; 8–128 letters, numbers, underscores, hyphens, or colons.
`input.last_name`	Required last name
`input.company`	Required current company name or ID
`input.linkedin_profile_url`	Optional exact public profile URL for disambiguation

Output fields

The response contains an output array. Available record fields include:

full_name
first_name
last_name
company_name
job_title
location
linkedin_profile_url
sales_navigator_profile_url
sales_navigator_profile_id
connection_degree
tenure_start
summary
profile_image_url

Fields not available from the source are omitted. Your parser must tolerate absent properties and empty arrays. Examples are illustrative, not live customer data.

Completion and retries

Both 200 and 202 are valid responses. Read status: a live call can remain queued when capacity is busy. Poll the run until it reaches a terminal state. A terminal failed run can have HTTP 200; inspect its error and status, not just the HTTP code.

Reuse the same idempotency key and request body after a network timeout. A changed request under the same key returns 409.

Coverage notes

Requires first_name, last_name, and current company name or ID. Optionally provide linkedin_profile_url to disambiguate. Searches at most ten source records and returns at most one exact name/current-company match. No match costs zero credits; multiple matches or an incomplete search fail without charging. No profile visit, full-profile fallback, experience history, email, or phone enrichment. Source capacity reserves ten search lines even though customer billing is at most one credit.

See coverage and limits before planning a production dependency. For async execution, replace /run/live with /run/async using the same input.