# rc.openPersonPage

Open a candidate's profile in LinkedIn Recruiter Lite and read their details and your seat's recruiting activity with them.

> The API Reference is also the SDK and CLI reference. Consecutive code fences marked `tab=HTTP`, `tab=Node`, `tab=Python` and `tab=CLI` are the same call on each surface (a fence marked `tab=HTTP,CLI` is the same text for both), and a block between `:::surface <names>` and `:::` applies only to the surfaces it names. Identifiers in the text are written as in Node and in HTTP JSON (camelCase); the Python SDK spells methods, parameters and result attributes in snake_case (`sendMessage` → `send_message`, `reconnectionLink` → `reconnection_link`), while names inside HTTP JSON stay camelCase.

Open a candidate's profile in LinkedIn Recruiter Lite and, optionally, read their details and the recruiting activity your seat has with them. Use it on its own with a Recruiter profile URL, or under [rc.doForPeople](/docs/action-rc-do-for-people) for each candidate of a search.

The account needs a Recruiter Lite seat and Linked API's Plus plan – see [Recruiter Lite](/docs/recruiter-lite-overview).

:::surface node,python
In the SDK this is the `rcFetchPerson` method. It takes the parameters below except `label`, which exists only in workflow JSON, and returns the result below in `data`.
:::

:::surface node
Unlike the API, `rcFetchPerson` reads the candidate's details unless you set `basicInfo` to `false`.
:::

:::surface python
Unlike the API, `rcFetchPerson` reads the candidate's details unless you set `basic_info` to `False`. The parameter written `basicInfo` below is `basic_info` in Python.
:::

:::surface cli
The command is `linkedin recruiter person fetch`. Its argument and flags are listed below. Unlike the API, it reads the candidate's details unless you pass `--no-basic-info`.
:::

## Constraints

> ⏺️ **Root Start:** allowed, when `personUrl` parameter is provided.

> ⬆️ **Parent Actions:** [rc.doForPeople](/docs/action-rc-do-for-people).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json tab=HTTP
{
  "actionType": "rc.openPersonPage",
  "label": "candidate1",
  "personUrl": "https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
  "basicInfo": true,
  "recruitingActivity": true
}
```

```typescript tab=Node
const workflow = await linkedapi.rcFetchPerson.execute({
  personUrl: "https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
  basicInfo: true,
  recruitingActivity: true
});

const { data, errors } = await linkedapi.rcFetchPerson.result(workflow.workflowId);
```

```python tab=Python
from linkedapi import RcOpenPersonPageParams

workflow = linkedapi.rc_fetch_person.execute(
    RcOpenPersonPageParams(
        person_url="https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
        basic_info=True,
        recruiting_activity=True,
    )
)

result = linkedapi.rc_fetch_person.result(workflow.workflow_id)
```

```bash tab=CLI
linkedin recruiter person fetch https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1 \
  --basic-info \
  --recruiting-activity \
  --json
```

In AI assistants, the MCP tool is `rc_fetch_person`. The n8n action is **Fetch person in Recruiter Lite**; the Make module is **Fetch Person in Recruiter Lite**.

| Parameter | Description |
| --- | --- |
| `label` | Optional. Label included in workflow completion. |
| `personUrl` | Required at the root, not allowed under [rc.doForPeople](/docs/action-rc-do-for-people), which supplies it. A Recruiter profile URL, `https://www.linkedin.com/talent/profile/…`, such as `recruiterProfileUrl` from [rc.searchPeople](/docs/action-rc-search-people) or [rc.retrieveProjectCandidates](/docs/action-rc-retrieve-project-candidates), or the `personRecruiterUrl` of a Recruiter Lite [inbox message](/docs/monitoring-inbox#recruiter-lite-inbox). A public profile URL (`linkedin.com/in/…`) is rejected with `invalidWorkflow`. |
| `basicInfo` | Optional. `true` to read the candidate's details. Defaults to `false`. The SDK method `rcFetchPerson`, the CLI, the MCP tool, n8n and Make default it to `true`. |
| `recruitingActivity` | Optional. `true` to read how much recruiting activity your seat has with the candidate. Defaults to `false`. |

:::surface cli
| Arg | Required | Description |
| --- | --- | --- |
| `url` | yes | Recruiter profile URL of the candidate, `https://www.linkedin.com/talent/profile/…` |

| Flag | Description |
| --- | --- |
| `--basic-info`, `--no-basic-info` | Read the candidate's details. On unless you pass `--no-basic-info`. |
| `--recruiting-activity`, `--no-recruiting-activity` | Read how much recruiting activity your seat has with the candidate. Off unless you pass `--recruiting-activity`. |
:::

Each call counts as one Recruiter profile view in the `rcPersonProfileViews` [limit](/docs/recruiter-lite-overview#limits), whichever fields you ask for.

When the Recruiter profile links to the candidate's public LinkedIn profile, Linked API remembers that link, whichever fields you ask for. [Inbox polling](/docs/monitoring-inbox#recruiter-lite-inbox) by the candidate's public URL can then find their Recruiter conversation.

## Result options

1. **Successful opening:**

```json
{
  "actionType": "rc.openPersonPage",
  "label": "candidate1",
  "success": true,
  "data": {
    "name": "Jane Example",
    "recruiterProfileUrl": "https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
    "headline": "Senior Backend Engineer at Example Cloud",
    "location": "Berlin, Germany",
    "avatarUrl": "https://media.licdn.com/dms/image/v2/C4D03AQExample/profile-displayphoto-shrink_100_100/0/1600000000000",
    "viewerState": { "connectionDegree": "2nd" },
    "publicUrl": "https://www.linkedin.com/in/jane-example",
    "industry": "Software Development",
    "recruitingActivity": {
      "projects": 2,
      "messages": 0,
      "feedback": 0,
      "attachments": 1
    }
  }
}
```

With `basicInfo`:

| Field | Meaning |
| --- | --- |
| `name` | Candidate's full name. |
| `recruiterProfileUrl` | The Recruiter profile that was opened, without query parameters. |
| `headline` | Headline, or an empty string. |
| `location` | Location, or an empty string. |
| `avatarUrl` | Profile photo URL, or `null` without a photo. |
| `viewerState.connectionDegree` | `1st`, `2nd` or `3rd+`, as Recruiter shows it next to the name, or `null` when it shows none or when the interface language is not [supported](/docs/recruiter-lite-overview#seat-requirements). |
| `publicUrl` | The candidate's public LinkedIn profile, `https://www.linkedin.com/in/…`. Pass it to the [standard actions](/docs/actions-overview#standard-actions-st), such as [st.openPersonPage](/docs/action-st-open-person-page). |
| `industry` | Industry of the candidate's current employer, as the profile shows it, or `null`. |

With `recruitingActivity`, the counts Recruiter shows on the profile's recruiting activity tabs, for your seat:

| Field | Meaning |
| --- | --- |
| `recruitingActivity.projects` | The count on the Projects tab: your projects the candidate is in. |
| `recruitingActivity.messages` | The count on the Messages tab. |
| `recruitingActivity.feedback` | The count on the Feedback tab. |
| `recruitingActivity.attachments` | The count on the Attachments tab. |

Each group of fields is present only when you ask for it. With `basicInfo` and `recruitingActivity` both `false`, the action only opens the profile, and `data` is an empty object.

`label` is included only if specified in the action parameters.

2. **Failed opening:**

```json
{
  "actionType": "rc.openPersonPage",
  "label": "candidate1",
  "success": false,
  "error": {
    "type": "personNotFound",
    "message": "This Recruiter profile could not be opened."
  }
}
```

Possible `error.type` values:

- `personNotFound` – Recruiter kept the profile URL but did not show the profile.
- `recruiterSignInRequired`, `recruiterTwoStepVerificationRequired`, `recruiterMultipleSessionsDetected` – the seat needs attention, see [account errors](/docs/recruiter-lite-overview#account-errors).
- `limitExceeded` – the account reached its `rcPersonProfileViews` [limit](/docs/recruiter-lite-overview#limits).
- `unexpectedError` – the profile could not be read: for example, Recruiter opened another page instead of the profile, or `basicInfo` was requested and the profile shows no public profile link.

Under [rc.doForPeople](/docs/action-rc-do-for-people), a failure stops the search at that candidate – see [Results and paging](/docs/action-rc-search-people#results-and-paging).
