---
title: "Get content of a job with a given id."
method: GET
path: "/jobs/{jobId}"
tags: ["jobs"]
---

# Get content of a job with a given id.

`GET /jobs/{jobId}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/jobs/{jobId}`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `jobs_read`

Get content of a job with a given id.

## Headers

- `Accept-Language` 'af' | 'am' | 'ar' | 'hy' | 'az' | 'eu' | 'bn' | 'bg' | 'ca' | 'zh-CN' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'en-GB' | 'en' | 'et' | 'fi' | 'fr' | 'fr-CA' | 'gl' | 'ka' | 'de' | 'el' | 'gu' | 'iw' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'kn' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'ms' | 'ml' | 'mr' | 'mn' | 'ne' | 'no' | 'fa' | 'fil' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'es' | 'es-MX' | 'sw' | 'sv' | 'ta' | 'te' | 'tr' | 'uk' | 'ur' | 'vi' | 'cy' | 'zu' | 'en-AU': Language code, can be two-letter for the standard variant or with additional two letters after a hyphen to identify a specific locale Value "pt-PT" is deprecated and will not work, use "pt" instead.

## Response `200`

Job

- JobDetails
  - `id` string
  - `title` string
  - `refNumber` string
  - `createdOn` string, date-time
  - `updatedOn` string, date-time: Job modification date
  - `lastActivityOn` string, date-time: Indicates last activity associated with a job
  - `department` Department
    - `id` string
    - `label` string, required
    - `description` string
  - `location` Location
    - `country` string
    - `countryCode` string, required
    - `regionCode` string
    - `region` string
    - `city` string, required
    - `address` string, address
    - `postalCode` string
    - `longitude` string
    - `latitude` string
    - `manual` boolean
    - `remote` boolean
    - `hybrid` boolean
    - `hybridDescription` string
  - `status` 'CREATED' | 'SOURCING' | 'FILLED' | 'INTERVIEW' | 'OFFER' | 'CANCELLED' | 'ON_HOLD' | 'OTHER'
  - `postingStatus` 'PUBLIC' | 'INTERNAL' | 'NOT_PUBLISHED' | 'PRIVATE'
  - `targetHiringDate` string, date-time
  - `hiringProcessId` string: ID of hiring process associated with this job
  - `industry` Property
    - `id` string, required
    - `label` string
  - `function` Property
    - `id` string, required
    - `label` string
  - `typeOfEmployment` Property
    - `id` string, required
    - `label` string
  - `experienceLevel` Property
    - `id` string, required
    - `label` string
  - `eeoCategory` Property
    - `id` string, required
    - `label` string
  - `template` boolean
  - `creator` UserIdentity
    - `id` string
    - `firstName` string
    - `lastName` string
  - `compensation` Compensation
    - `min` number, double, nullable
    - `max` number, double, nullable
    - `currency` string, nullable
    - `period` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', nullable: The time period to which the proposed min and max compensation values apply
  - `jobAd` JobAdInput
    - `sections` JobAdSections
      - `companyDescription` JobAdSection
        - `title` string
        - `text` string
      - `jobDescription` JobAdSection
        - `title` string
        - `text` string
      - `qualifications` JobAdSection
        - `title` string
        - `text` string
      - `additionalInformation` JobAdSection
        - `title` string
        - `text` string
      - `videos` JobAdVideos
        - `urls` string[]
    - `language` Language
      - `code` string, required
      - `label` string
      - `labelNative` string
  - `properties` JobProperty[]
    - `id` string, required
    - `key` string
    - `label` string
    - `value` JobPropertyValue, required
      - `id` string
      - `externalCode` string: Cross-system code identifying the value in an external system, when one is set.
      - `label` string
  - `actions` object
    - `hiringTeam` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD', required
    - `publications` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD', required
    - `positions` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD', required
    - `applyOnWeb` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD', required
    - `details` Action
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD', required

## Other responses

- `401`: Job access denied

---

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