v1

latestOpenAPI 3.1.02026-07-224239180.9 KB
Job

List jobs

Returns paginated job summaries with status and ATS information. Combine IDs, status, name, ATS ID, and record timestamps to narrow results; every supplied filter is applied together. Use the cursor to continue the same filtered result set.

get/v1/jobs

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.

[
  "job_a1b2c3d4e5f64789a1b2c3d4e5f64789"
]
statusesstring[] nullable

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

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

namestring

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

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

ats_idsstring[] nullable

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

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

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": "job_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "hiring_team": [
        {
          "employee": {
            "id": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
          }
        }
      ]
    }
  ]
}