---
title: "Get one job"
method: GET
path: "/jobs/{idOrSlug}"
---

# Get one job

`GET /jobs/{idOrSlug}`

## Request

- Base URL: `https://api.hiddenjobs.dev/v1`
- URL: `https://api.hiddenjobs.dev/v1/jobs/{idOrSlug}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hiddenjobs.dev/v1/oauth/authorize`, token URL `https://api.hiddenjobs.dev/v1/oauth/token`, scopes: `email`)

Use the source and exact id returned by search. External details are reread through the API/feed; an absent listing does not prove the job has closed.

## Path parameters

- `idOrSlug` string, required

## Query parameters

- `source` 'hiddenjobs' | 'jobicy' | 'weworkremotely' | 'remoteok' | 'himalayas', required

## Response `200`

Job data. Hidden Jobs employer links are withheld; external source links and attribution are included.

- JobResponse
  - `data` Job
    - `id` string, uuid, required
    - `title` string, required
    - `description` string, required
    - `descriptionPreview` string
    - `salary` string
    - `location` string, nullable
    - `category` string
    - `employmentType` string, nullable
    - `jobType` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
    - `validThrough` string, nullable
    - `experienceLevel` string, nullable
    - `skills` string[]
    - `remoteScope` string, nullable
    - `remoteLocationCodes` string[]
    - `remoteLocationLabel` string, nullable
    - `hasApplicationLink` boolean, required
    - `source` 'hiddenjobs' | 'jobicy' | 'weworkremotely' | 'remoteok' | 'himalayas'
    - `sourceName` string
    - `sourceUrl` string, uri
    - `applicationUrl` string, uri
    - `attribution` object
      - `name` string
      - `url` string, uri
      - `linkRel` 'follow'
      - `logoAllowed` boolean
    - `timezoneRestrictions` number[]

## Other responses

- `401`: Missing, invalid, revoked or expired API key or OAuth access token
- `404`: Job not found

---

[API](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api.md) · [All operations](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/revisions/c1d57d8e4720?raw)