---
title: "Get a profile in depth"
method: POST
path: "/v1/actions/get_profile_details"
tags: ["Profile"]
---

# Get a profile in depth

`POST /v1/actions/get_profile_details`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/get_profile_details`
- Auth: HTTP bearer

Read one person's profile in depth, live, with the sections you ask for.

skills[].endorsementId is present only when sections includes "skills".

publicProfileUrl can be absent: a real profile read came back without it. publicIdentifier was there, and linkedin.com/in/<publicIdentifier> is the link.

With via "sales_navigator" or "recruiter", person must be that product's id (a public link is not accepted there), and providerId is then that product's id, not a member id.

LinkedIn counts this as a profile view, and throttles heavy use: a section it held back is named in throttledSections and comes back empty.

networkDistance is FIRST_DEGREE / SECOND_DEGREE / THIRD_DEGREE / OUT_OF_NETWORK.

Docs: https://heyreagent.com/docs/actions/get_profile_details

## Request body

- object
  - `person` string, required: The person: a LinkedIn profile URL or member id.
  - `sections` string[]: Which sections to include in full. Omit for the basic profile.
  - `via` 'sales_navigator' | 'recruiter': Read through this product instead of ordinary LinkedIn.
  - `notify` boolean: Whether the person is told you viewed their profile (default false).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: providerId, publicIdentifier, firstName, lastName, pronoun, headline, summary, contactInfo.emails, contactInfo.phones, contactInfo.adresses, birthdate.month, birthdate.day, primaryLocale.country, primaryLocale.language, location, websites, creatorWebsite.url, creatorWebsite.description, profilePictureUrl, profilePictureUrlLarge, backgroundPictureUrl, hashtags, canSendInmail, connectedAt, isOpenProfile, isPremium, isInfluencer, isCreator, isHiring, isOpenToWork, isSavedLead, isCrmImported, isRelationship, isSelf, invitation.type, invitation.status, workExperience[].id, workExperience[].position, workExperience[].companyId, workExperience[].companyUrl, workExperience[].companyPictureUrl, workExperience[].industry, workExperience[].company, workExperience[].location, workExperience[].description, workExperience[].skills, workExperience[].current, workExperience[].status, workExperience[].start, workExperience[].end, workExperienceTotalCount, volunteeringExperience[].company, volunteeringExperience[].description, volunteeringExperience[].role, volunteeringExperience[].cause, volunteeringExperience[].start, volunteeringExperience[].end, volunteeringExperienceTotalCount, education[].id, education[].degree, education[].grade, education[].description, education[].activities, education[].school, education[].schoolId, education[].schoolUrl, education[].schoolPictureUrl, education[].skills, education[].fieldOfStudy, education[].start, education[].end, educationTotalCount, skills[].name, skills[].endorsementCount, skills[].endorsementId, skills[].insights, skills[].endorsed, skillsTotalCount, languages[].name, languages[].proficiency, languagesTotalCount, certifications[].name, certifications[].organization, certifications[].url, certificationsTotalCount, projects[].name, projects[].description, projects[].skills, projects[].start, projects[].end, projectsTotalCount, recommendations.receivedTotalCount, recommendations.givenTotalCount, tags[].id, tags[].name, notes[].projectId, notes[].content, notes[].createdAt, candidateId, recruitingActivity[].createdAt, recruitingActivity[].updatedAt, recruitingActivity[].event, recruitingActivity[].content, recruitingActivity[].status, recruitingActivity[].projectId, recruitingActivity[].projectName, recruitingActivity[].state, throttledSections, followerCount, connectionsCount, sharedConnectionsCount, networkDistance, publicProfileUrl, locked, unlockCredit.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)