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

# Get Job Applications

`GET /api/v1/applicant_tracking/applications`

Get a list of applications. The authenticated caller must have access to ATS settings. Combine as many different optional parameter filters as you like.

OAuth Scopes: hiring:applications

## Query parameters

- `page` integer
- `jobId` integer
- `applicationStatusId` string
- `applicationStatus` string
- `jobStatusGroups` string
- `searchString` string
- `sortBy` 'first_name' | 'job_title' | 'rating' | 'phone' | 'status' | 'last_updated' | 'created_date'
- `sortOrder` 'ASC' | 'DESC'
- `newSince` string

## Response `200`

Success. Returns a paginated list of applications.

- object
  - `paginationComplete` boolean — Indicates whether there are more pages of results available
  - `nextPageUrl` string, nullable — URL to fetch the next page of results, or null if there are no more results
  - `applications` object[] — List of application objects
    - `id` integer — Application ID
    - `appliedDate` string, date-time — ISO 8601 datetime when the application was submitted
    - `status` object — Current status of the application
      - `id` integer — Status ID
      - `label` string — Status name
    - `rating` integer, nullable — Candidate rating (1-5) or null if not rated
    - `applicant` object — Information about the applicant
      - `id` integer — Applicant ID
      - `firstName` string — Applicant's first name
      - `lastName` string — Applicant's last name
      - `avatar` string, nullable — URL to applicant's avatar image, or null
      - `email` string — Applicant's email address
      - `source` string — Source of the application
    - `job` object — Information about the job position
      - `id` integer — Job position ID
      - `title` object — Job position title
        - `id` integer, nullable — Title ID, or null if not set
        - `label` string — Title text

## 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/versions/19ebf391a399/schema)
