Recruiter: Projects

List Recruiter projects

List Recruiter projects visible to the account. Supports filtering by status and keywords, sorting, and opaque cursor-based pagination. Requires a Recruiter seat.

get/v1/{account_id}/recruiter/projects

Request

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

Path parameters

account_idstring required

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

Query parameters

statusstring[]

Filter by project status (repeatable, flat). One or more of: ACTIVE, CLOSED, DRAFT, REVIEW.

sort_by'LAST_USED_BY_ME' | 'MOST_USED_BY_ME' | 'LAST_VIEWED_BY_ME' | 'NEWEST_TO_OLDEST' | 'OLDEST_TO_NEWEST' | 'ALPHABETICAL' | 'REVERSE_ALPHABETICAL'

Field to sort results by. Defaults to LAST_USED_BY_ME.

keywordsstring

Filter by project name (trimmed before use; never persisted).

limitinteger

Number of projects to return (1-100). Defaults to 10.

cursorstring

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

Response

List of Recruiter projects visible to the account. Requires a Recruiter seat.

object'recruiter_project_list' required

Response type discriminator.

cursorstring

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

total_countnumber

Total number of projects, 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.