Skip to main content
GET
List jobs
Lists all job postings for the API key’s company with pagination and filtering support.

Overview

The list jobs endpoint allows you to retrieve all job postings in your company. You can filter by status, search by title or description, and paginate through results. This is useful for managing your job pipeline and finding jobs before creating candidates.

Use Cases

  • Job Management: Review all active job postings
  • Status Filtering: Find jobs by status (OPEN, CLOSED)
  • Search: Locate specific jobs by title or description
  • Bulk Operations: Retrieve jobs for bulk candidate assignment

Basic Usage

With Filters

Company Scoping

All returned jobs belong to your API key’s company. ATS keys can filter by companyId to access jobs from specific companies they manage.

Jobs Resource Guide

Learn about job management and filtering options

Pagination Guide

Understand pagination best practices

Get Job

Retrieve a specific job by ID

Authorizations

Authorization
string
header
required

API key for authentication using Bearer scheme

Query Parameters

page
integer
default:1

Page number (1-based)

Required range: 1 <= x <= 10000
Example:

1

limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
Example:

20

companyId
string<uuid>

Company ID (required for ATS keys, optional for regular keys)

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>

Filter by job status

Available options:
UNDEFINED,
OPEN,
CLOSED
Example:

"OPEN"

Search by job title

Example:

"TypeScript Developer"

Response

200 - application/json
data
object[]
required

Array of jobs

total
number
required

Total number of items

Example:

150

page
number
required

Current page number

Example:

1

limit
number
required

Number of items per page

Example:

20

totalPages
number
required

Total number of pages

Example:

8