---
title: "jobPosting.list"
method: POST
path: "/jobPosting.list"
tags: ["Job Posting"]
---

# jobPosting.list

`POST /jobPosting.list`

Lists published job postings. By default, only published job postings are returned.

Set `includeUnpublishedJobPostings` to `true` to also include unpublished (draft) job postings.

**Important**: By default, this endpoint includes all listed and unlisted job postings. Unlisted job postings should not be displayed publicly.
If you are using the API to publicly expose job postings, set the `listedOnly` parameter to `true` when calling this API so that you only fetch listed job postings that can be displayed publicly.

**Requires the [`jobsRead`](authentication#permissions-jobpostinglist) permission.**

## Request body

- JobPostingListRequest
  - `location` string, nullable — Filter by location name (case sensitive)
  - `department` string, nullable — Filter by department name (case sensitive)
  - `listedOnly` boolean, nullable — If true, filter out unlisted job postings.
  - `includeUnpublishedJobPostings` boolean, nullable — If true, include unpublished (draft) job postings in addition to published job postings.
  - `jobBoardId` string, uuid, nullable — If provided, only returns the job postings on the specified job board. If omitted, this API will return the job postings on the primary external job board.

## Response `200`

Responses from the jobPosting.list endpoint

- union
  - JobPostingListSuccessResponse
    - `success` true, required
    - `results` JobPostingBrief[], required
      - `id` string, uuid, required — The job posting's id
      - `title` string, required — The job posting's title
      - `jobId` string, uuid, required — The id of the job associated with the job posting
      - `departmentName` string, required — The name of the department associated with the job posting
      - `teamName` string, required — The name of the team associated with the job posting. `teamName` and `departmentName` will be the same if the team does not have a parent team specified.
      - `locationName` string, required — The name of the primary location associated with the job posting
      - `locationIds` JobPostingLocationIds, required
        - `primaryLocationId` string, uuid, nullable, required — The primary location id for the job posting
        - `secondaryLocationIds` string[], required — The secondary location ids for the job posting
      - `workplaceType` 'OnSite' | 'Hybrid' | 'Remote', nullable — The type of workplace
      - `employmentType` string, required — The employment type for the job posting
      - `isListed` boolean, required — Whether or not the job posting is listed
      - `publishedDate` string, date, nullable, required — The date the job posting was published. Null for unpublished (draft) job postings.
      - `applicationDeadline` string, nullable — The date and time when applications will no longer be accepted
      - `externalLink` string, uri, nullable, required — The external link to the job posting. Will be null if the job posting is on an internal job board.
      - `applyLink` string, uri, required — The link to apply to the job posting. Will be to the public job board if the job posting is on an external job board, or to the internal job board if the job posting is on an internal job board.
      - `compensationTierSummary` string, nullable — A summary of *all* the job posting's valid compensation tiers in the same format shown on Ashby-hosted Job Boards
      - `shouldDisplayCompensationOnJobBoard` boolean, required — Whether the job posting's settings specify that compensation should be shown to applicants when the posting is listed among other job postings
      - `updatedAt` string, date-time, required — The date and time when the job posting was last updated
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

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