rc.retrieveProjects
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 – see Recruiter Lite.
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.
The command is linkedin recruiter projects. Its flag is listed below.
Constraints
⏺️ Root Start: allowed.
⬆️ Parent Actions: N/A.
⬇️ Child Actions: N/A.
Parameters
{
"actionType": "rc.retrieveProjects",
"label": "projects",
"limit": 50
}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. |
| 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 is how a project leaves this list.
- Pages. The action reads Recruiter's project list page by page until it has
limitprojects 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
dataarray.
Result options
- Successful reading:
{
"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.
- Failed reading:
{
"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.unexpectedError– the project list could not be read completely.