---
title: "Get Job Summaries"
method: GET
path: "/api/v1/applicant_tracking/jobs"
tags: ["Applicant Tracking", "Public API"]
---

# Get Job Summaries

`GET /api/v1/applicant_tracking/jobs`

Get a list of job opening summaries. The authenticated caller must have access to ATS settings. Results can be filtered by status group and sorted by various fields. By default returns all non-deleted job openings.

OAuth Scopes: hiring:applications

## Query parameters

- `statusGroups` string
- `status_ids` string
- `sortBy` 'count' | 'title' | 'lead' | 'created' | 'status'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

Success. Returns an array of job opening summary objects.

- object[]
  - `id` integer — Job opening ID
  - `title` object — Job title
    - `id` integer, nullable — Title ID, or null if not set
    - `label` string — Title text
  - `postedDate` string, date-time — ISO 8601 datetime when the job opening was posted
  - `location` object, nullable — Location information
    - `id` integer — Location ID
    - `label` string — Location display name
    - `address` object — Full address of the location
  - `department` object, nullable — Department information
    - `id` integer — Department ID
    - `label` string — Department name
  - `status` object — Job opening status
    - `id` integer — Status ID
    - `label` string — Status name
  - `hiringLead` object, nullable — The hiring lead for this job opening
    - `employeeId` integer — Internal employee ID
    - `firstName` string — First name
    - `lastName` string — Last name
    - `avatar` string, nullable — URL to avatar image
    - `jobTitle` object, nullable — Hiring lead's job title
  - `newApplicantsCount` integer — Number of applicants in 'New' status
  - `activeApplicantsCount` integer — Number of applicants in an active status
  - `totalApplicantsCount` integer — Total number of applicants
  - `postingUrl` string, nullable — Public URL for the job posting, or null if not posted

## Other responses

- `400` — Bad request parameters.
- `401` — Unauthorized. Invalid API credentials.
- `403` — Insufficient user permissions or API access is not turned on.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)