Recruiter: Jobs

List applicants in a project's talent pool

List applicants in a Recruiter project's talent pool (POST-as-list; the body carries filters, no state mutates). The channel_id (a JOB_POSTING talent-pool channel) is REQUIRED, read it off talent_pool.channels[] of GET .../recruiter/projects/{project_id}. Requires a Recruiter seat.

post/v1/{account_id}/recruiter/projects/{project_id}/talent-pool/applicants

Request

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

Path parameters

account_idstring required

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

project_idstring required

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

Query parameters

cursorstring

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

limitinteger

Number of applicants to return (1-100). Defaults to 25.

Request body

channel_idstring required

The ID of the JOB_POSTING channel from the Talent Pool. SDK-confirmed REQUIRED.

keywordsstring

Free-text keyword search. Trimmed before use; never persisted.

sort_by'SCREENING_REQUIREMENTS' | 'RELEVANCE' | 'NEWEST_FIRST' | 'ALPHABETICAL'

Sort order for the applicant list.

spotlightsstring[]

Filter by candidate spotlight.

locationstring[]

Resolved LOCATION parameter ids.

skillsstring[]

Resolved SKILL parameter ids.

industrystring[]

Resolved INDUSTRY parameter ids.

job_titlestring[]

Resolved JOB_TITLE parameter ids.

spoken_language_proficiency'ELEMENTARY' | 'LIMITED_WORKING' | 'PROFESSIONAL_WORKING' | 'FULL_PROFESSIONAL' | 'NATIVE_OR_BILINGUAL'

Required proficiency level for the spoken languages.

senioritystring[]

Filter by seniority level.

job_functionstring[]

Resolved JOB_FUNCTION parameter ids.

Response

List of talent-pool applicants matching the filters. Requires a Recruiter seat.

object'recruiter_job_applicant_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 applicants, 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.