Jobs

List job applicants

Lists applicants for a classic job posting the connected account owns. This is a read, POST is used to carry the filter body, matching the /v1/search/* convention; nothing is mutated. Omit ratings to see the full applicant funnel; the server sends all four rating values by default.

post/v1/{account_id}/jobs/{job_id}/applicants

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/jobs/{job_id}/applicants
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account that owns the job posting.

job_idstring required

The job posting's numeric id, e.g. 4100000000 (from the LinkedIn job URL or a search/jobs result). A full URL is not accepted here.

Query parameters

limitinteger

Number of results to return (1-100).

cursorstring

Opaque pagination cursor from a previous response.

Request body

ratingsstring[]

Filter by applicant rating. Omit to see the full funnel: the server sends all four ratings by default so the total matches the posting's own applicant count.

keywordsstring

Free-text keyword filter over applicant profiles.

sort_by'APPLIED_DATE' | 'FIRST_NAME' | 'LAST_NAME'

Sort order for the returned applicants. Defaults to APPLIED_DATE.

locationstring[]

Location parameter ids from GET /v1/{account_id}/search/parameters.

skillsstring[]

Skill parameter ids from GET /v1/{account_id}/search/parameters.

Response

Applicants matching the filter. Omitting ratings requests all four values, so the default view reflects the posting's whole applicant funnel. Content fields (profile, screening-question answers) are returned verbatim and are never stored.

object'job_applicant_list' required

Response type discriminator.

cursorstring

Opaque pagination cursor for the next page. Present only when more applicants remain past this page, omit on the first request, pass back verbatim to page forward.

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.