# rc.retrieveProjects

List the active projects of a LinkedIn Recruiter Lite seat, with their IDs, names, creation dates and candidate counts.

> 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.

List the active projects of the LinkedIn Recruiter Lite seat: the projects Recruiter shows under its default Active filter. Use a project's `projectId` with the other project actions.

The account needs a Recruiter Lite seat, Linked API's Plus plan and a [supported LinkedIn interface language](/docs/recruiter-lite-overview#seat-requirements) – see [Recruiter Lite](/docs/recruiter-lite-overview).

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

:::surface cli
The command is `linkedin recruiter projects`. Its flag is listed below.
:::

## Constraints

> ⏺️ **Root Start:** allowed.

> ⬆️ **Parent Actions:** N/A.

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

## Parameters

```json tab=HTTP
{
  "actionType": "rc.retrieveProjects",
  "label": "projects",
  "limit": 50
}
```

```typescript tab=Node
const workflow = await linkedapi.rcRetrieveProjects.execute({
  limit: 50
});

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

```python tab=Python
from linkedapi import RcRetrieveProjectsParams

workflow = linkedapi.rc_retrieve_projects.execute(
    RcRetrieveProjectsParams(
        limit=50,
    )
)

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

```bash tab=CLI
linkedin recruiter projects --limit 50 --json
```

In AI assistants, the MCP tool is `rc_retrieve_projects`. The n8n action is **Retrieve projects in Recruiter Lite**; the Make module is **Retrieve Projects in Recruiter Lite**.

| Parameter | Description |
| --- | --- |
| `label` | Optional. Label included in workflow completion. |
| `limit` | Optional. Number of projects to return, from 1 to 1000. Defaults to 25. |

:::surface cli
| Flag | Description |
| --- | --- |
| `--limit` | Number of projects to return, 1–1000; default 25. |
:::

## Reading behaviour

- **Active projects only.** Archived projects are not listed. Recruiter Lite cannot delete a project, so archiving with [rc.archiveProject](/docs/action-rc-archive-project) is how a project leaves this list.
- **Pages.** The action reads Recruiter's project list page by page until it has `limit` projects or the list ends. If a page does not change after its Next click, or still shows the previous rows, the action fails rather than return a short list.
- **No projects.** A seat without active projects succeeds with an empty `data` array.

## Result options

1. **Successful reading:**

```json
{
  "actionType": "rc.retrieveProjects",
  "label": "projects",
  "success": true,
  "data": [
    {
      "projectId": "1700000001",
      "name": "Data Engineers – Amsterdam",
      "createdAt": "2026-10-05",
      "candidateCount": 42,
      "projectUrl": "https://www.linkedin.com/talent/hire/1700000001/overview"
    },
    {
      "projectId": "1700000002",
      "name": "Backend Engineers",
      "createdAt": "2026-11-02",
      "candidateCount": 0,
      "projectUrl": "https://www.linkedin.com/talent/hire/1700000002/overview"
    }
  ]
}
```

| Field | Meaning |
| --- | --- |
| `projectId` | Project ID, a string of digits. Pass it as `projectId` to the other project actions. |
| `name` | Project name. |
| `createdAt` | Creation date, `YYYY-MM-DD`. |
| `candidateCount` | Number of candidates in the project, as the list shows it. |
| `projectUrl` | The project's overview page in Recruiter. |

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

2. **Failed reading:**

```json
{
  "actionType": "rc.retrieveProjects",
  "label": "projects",
  "success": false,
  "error": {
    "type": "recruiterSignInRequired",
    "message": "Sign in to LinkedIn Recruiter in this account's browser, then retry. If the account has no Recruiter Lite subscription, add one first."
  }
}
```

Possible `error.type` values:

- `recruiterSignInRequired`, `recruiterTwoStepVerificationRequired`, `recruiterMultipleSessionsDetected` – the seat needs attention, see [account errors](/docs/recruiter-lite-overview#account-errors).
- `unexpectedError` – the project list could not be read completely.
