v1

latestOpenAPI 3.1.02026-07-224239180.9 KB
Interviewer

List interviewers

Lists interviewer load, pause state, work hours, and module training. Omit statuses for the default active-only view; pass statuses=ACTIVE,ARCHIVED to include both active and archived interviewers.

get/v1/interviewers

Query parameters

cursorstring

Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.

Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.

limitinteger

Page size. Must be between 1 and 100; defaults to 25.

Page size. Must be between 1 and 100; defaults to 25.

idsstring[] nullable

Comma-separated list of IDs; maximum 100 values.

Comma-separated list of IDs; maximum 100 values.

[
  "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
]
searchstring

Case-insensitive substring search across interviewer name and email; combines with other filters using AND.

Case-insensitive substring search across interviewer name and email; combines with other filters using AND.

namestring

Case-insensitive substring match on interviewer name; combines with other filters using AND.

Case-insensitive substring match on interviewer name; combines with other filters using AND.

emailstring

Case-insensitive exact match on interviewer email; combines with other filters using AND.

Case-insensitive exact match on interviewer email; combines with other filters using AND.

statusesstring[] nullable

Matches interviewers with any listed status; combines with other filters using AND.

Matches interviewers with any listed status; combines with other filters using AND.

module_idsstring[] nullable

Matches interviewers assigned to any listed interview module; combines with other filters using AND.

Matches interviewers assigned to any listed interview module; combines with other filters using AND.

[
  "mod_a1b2c3d4e5f64789a1b2c3d4e5f64789"
]
manager_idsstring[] nullable

Matches interviewers managed by any listed employee; combines with other filters using AND.

Matches interviewers managed by any listed employee; combines with other filters using AND.

[
  "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
]
ats_idsstring[] nullable

Matches interviewers whose ATS ID is one of these exact values; combines with other filters using AND.

Matches interviewers whose ATS ID is one of these exact values; combines with other filters using AND.

ats_type'GREENHOUSE' | 'ASHBY' | 'LEVER' | 'WORKDAY' | 'SMARTRECRUITERS' | 'GEM' | 'KOMBO'

Filters by ATS provider.

Filters by ATS provider.

created_at_gtestring date-time

Filters records created at or after this timestamp.

Filters records created at or after this timestamp.

created_at_ltestring date-time

Filters records created at or before this timestamp.

Filters records created at or before this timestamp.

updated_at_gtestring date-time

Filters records updated at or after this timestamp.

Filters records updated at or after this timestamp.

updated_at_ltestring date-time

Filters records updated at or before this timestamp.

Filters records updated at or before this timestamp.

Response

Success

Example response

{
  "data": [
    {
      "id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "manager_id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "attributes": [
        {
          "attribute_name": {
            "id": "att_a1b2c3d4e5f64789a1b2c3d4e5f64789"
          },
          "values": [
            {
              "id": "atv_a1b2c3d4e5f64789a1b2c3d4e5f64789"
            }
          ]
        }
      ],
      "modules": [
        {
          "module": {
            "id": "mod_a1b2c3d4e5f64789a1b2c3d4e5f64789"
          }
        }
      ]
    }
  ]
}