---
title: "Get Job Openings"
method: GET
path: "/companies/{company_id_or_domain}/job_openings"
tags: ["Job Openings Dataset"]
---

# Get Job Openings

`GET /companies/{company_id_or_domain}/job_openings`

## Request

- Base URL: `https://predictleads.com/api/v3`
- URL: `https://predictleads.com/api/v3/companies/{company_id_or_domain}/job_openings`
- Auth: one of:
  - API key in header `X-API-KEY` and API key in header `X-API-TOKEN`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://oauth.predictleads.com/token`

Returns a list of company's Job Openings.

## Path parameters

- `company_id_or_domain` string, required

## Query parameters

- `active_only` boolean
- `not_closed` boolean
- `location` string
- `first_seen_at_from` string, date
- `first_seen_at_until` string, date
- `last_seen_at_from` string, date
- `last_seen_at_until` string, date
- `with_description_only` boolean
- `with_location_only` boolean
- `categories` string[]
- `page` integer
- `limit` integer

## Response `200`

Request was successfully processed.

- JobOpeningsDataset: PredictLeads has historical jobs data since 2016 that includes over 300 million records, and is available for 3 million companies, which includes an average of 9.8 million active jobs at any given time. <br><br> Job Openings are sourced directly from company websites which includes their career subpages, and ATS integrations. All Jobs are categorized using industry-standard <a target="_blank" rel="noopener" href="https://www.onetonline.org/">O\*NET codes</a>. <br><br> The Job Openings Dataset includes fields such as Job Opening Title, Job Opening URL, First Seen At, Last Seen At, Location, Category, Seniority, Description, Salary, Contract Type, O\*NET Job Category Codes and other Job Opening information.
  - `data` JobOpening[], required (unresolved $ref)
  - `included` CompanyLite[], required: Contains objects referenced in property `relationships`. (unresolved $ref)
  - `meta` object: Meta information about `JobOpeningsDataset` object.
    - `schema_version` string, required: Represents schema version of objects.
    - `record_state` 'active', required: Represents record state of objects.
    - `count` integer: Total number of results. <br> **NOTE**: Only included in API responses when the request parameter `page` is provided, for performance reasons.
    - `crawler_potentially_blocked` boolean: Whether our crawlers returned errors indicating the website might be blocking us. <br> **NOTE**: Only shown in API responses.
    - `no_active_openings_confirmed` boolean, nullable: Whether the absence of active job openings has been confirmed by the company's jobs subpage. <br> `null` unless an `active_only=true` request returns no openings (i.e. not an `active_only` request, the website has not been processed yet, or active openings were returned). When set, `true` means the jobs subpage confirmed the absence and `false` means it did not. <br> **NOTE**: Only shown in API responses.

## Other responses

- `400`: Invalid request body or parameters.
- `401`: Authentication credentials are invalid or API subscription is not activated.
- `402`: Exceeded the monthly request limit.
- `403`: Request rate over limit.
- `404`: Record not found.
- `422`: Provided data failed to validate.
- `429`: Too many requests.
- `500`: Internal server error.
- `503`: Service temporarily unavailable.

## Changes

- **2026-10-01** `113413aee4a2`: 1 info
  - api operation id `company_job_openings` removed and replaced with `get_api_v3_companies_job_openings`
- **2026-09-29** `bf33620a940b`: 1 breaking
  - the `data/items/attributes/url` response's property format changed from `uri` to no format for status `200`
- **2026-09-01** `a56831a1efd4`: 1 warning, 4 info
  - for the `query` request parameter `categories`, the type of property `items/` changed from no type to `string`
  - added the new optional `query` request parameter `location`
  - added the non-success response with the status `503`
  - added the optional property `meta/crawler_potentially_blocked` to the response with the `200` status
  - …1 more
- **2026-04-15** `d5d7fee516cc`: 3 info
  - removed the `non_manager` enum value from the `data/items/attributes/seniority` response property for the response status `200`
  - added the required property `data/items/attributes/normalized_title` to the response with the `200` status
  - added the required property `data/items/attributes/translated_title` to the response with the `200` status

[Operation history](https://skmtc.dev/predictleads/apis/predictleads-api-reference/changes/companies/:company_id_or_domain/job_openings/get.md)

---

[API](https://skmtc.dev/predictleads/apis/predictleads-api-reference.md) - [All operations](https://skmtc.dev/predictleads/apis/predictleads-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/predictleads/apis/predictleads-api-reference/revisions/ccb9fec6a710?raw)