Recruiter: Projects

List pipeline candidates

List candidates in a Recruiter project's pipeline. A POST body carries the (all-optional) filter set, keywords, stage, sort, spotlights, recruiting activity, skills, experience, and more. Pagination is driven by the limit (1-5000) and cursor query params. Requires a Recruiter seat.

post/v1/{account_id}/recruiter/projects/{project_id}/pipeline

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/recruiter/projects/{project_id}/pipeline
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose Recruiter seat lists the pipeline.

project_idstring required

The project ID. Obtain it from data[].id of GET .../recruiter/projects.

Query parameters

limitinteger

Number of pipeline candidates to return (1-5000). Defaults to 25.

cursorstring

Opaque pagination cursor from a previous response. Omit for the first page.

Request body

keywordsstring
stage_idstring

Filter to a single pipeline stage id.

sort_by'LAST_MODIFIED' | 'ALPHABETICAL'

Sort field. One of: LAST_MODIFIED, ALPHABETICAL.

spotlightsstring[]

Filter by candidate spotlight. One or more of: OPEN_TO_WORK, ACTIVE_TALENT, MISSED_CANDIDATES.

added_bystring[]

Filter by the recruiter(s) who added the candidate.

skillsstring[]

Filter by resolved skill parameter ids.

job_titlestring[]

Filter by resolved job-title parameter ids.

current_companystring[]

Filter by resolved company parameter ids.

current_locationstring[]

Filter by resolved location parameter ids.

Response

List of candidates in the project's pipeline, matching any supplied filters. Requires a Recruiter seat.

object'recruiter_pipeline_candidate_list' required

Response type discriminator.

cursorstring

Opaque cursor for the next page. Absent when there are no more results.

total_countnumber

Total number of matching candidates, when the platform returns it.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.