---
title: "Get a single Job Opening by ID"
method: GET
path: "/job_openings/{id}"
tags: ["Job Openings Dataset"]
---

# Get a single Job Opening by ID

`GET /job_openings/{id}`

Returns a single Job Opening.

## Path parameters

- `id` string, uuid, required

## Response `200`

Request was successfully processed.

- JobOpeningsDataset — PredictLeads has historical jobs data since 2016 that includes over 270 million records, and is available for 2.7 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.

---

[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-service-production.skmtc.workers.dev/v1/apis/predictleads/predictleads-api-reference/revisions/a56831a1efd4/schema)