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.

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.

ParameterDescription
labelOptional. Label included in workflow completion.
limitOptional. Number of projects to return, from 1 to 1000. Defaults to 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 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"
    }
  ]
}
FieldMeaning
projectIdProject ID, a string of digits. Pass it as projectId to the other project actions.
nameProject name.
createdAtCreation date, YYYY-MM-DD.
candidateCountNumber of candidates in the project, as the list shows it.
projectUrlThe project's overview page in Recruiter.

label is included only if specified in the action parameters.

  1. 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.
  • unexpectedError – the project list could not be read completely.