Recruiter: Search

Resolve search-filter IDs (Recruiter)

Resolves human-readable terms to opaque Recruiter filter ids for pipeline, search, and applicant requests. Body is discriminated by source: APPLICANTS/PIPELINE require project_id, others do not. Requires a Recruiter seat.

post/v1/{account_id}/recruiter/search/parameters

Request

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

Path parameters

account_idstring required

The account ID (acc_...) whose Recruiter seat resolves the parameters.

Query parameters

offsetinteger

Zero-based pagination offset. Defaults to 0.

limitinteger

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

Request body

OR
OR
OR

Response

Resolved Recruiter filter parameter ids. Pass the returned id values in structured filter arrays on the ops that reference this filter family (pipeline, search, applicants).

object'recruiter_search_parameter_list' required

Response type discriminator.

cursorstring

Opaque cursor for the next page. Only present when the platform returns one.

total_countnumber

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