API Reference/Endpoints
List Recruiter hiring projects
GET/api/linkedin/gateway/linkedin/projects
Lists the hiring projects visible to a LinkedIn Recruiter seat, each with its linked job posting and applicant counts. Requires the connected account to have an active Recruiter contract — see List available contracts.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Query parameters
FieldTypeDescription
account_id *stringA connected account's id.
sort_by"NAME" | "FAVORITE" | "CREATED_TIME" | "ACCESSED_TIME" | "ENGAGED_TIME" | "ENGAGEMENT_COUNT"Defaults to ACCESSED_TIME.
sort_order"ASCENDING" | "DESCENDING"Defaults to DESCENDING.
limitnumber1–100. Defaults to 10.
cursorstringFrom the previous page's cursor field, to continue paging.
Response fields
FieldTypeDescription
object"RecruiterHiringProjectList"Always this value.
items[].name / owner_namestringThe project's name and who owns it.
items[].job_postingobjectThe linked job posting — state, title, location, applicant and view counts, cost.
total_countnumberTotal projects available.
cursorstring | nullPass back to fetch the next page. Null once exhausted.
Errors
·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key, or the account has no active Recruiter contract.
