---
title: "Get posting by posting id or uuid for given company"
method: GET
path: "/v1/companies/{companyIdentifier}/postings/{postingId}"
tags: ["postings"]
---

# Get posting by posting id or uuid for given company

`GET /v1/companies/{companyIdentifier}/postings/{postingId}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/v1/companies/{companyIdentifier}/postings/{postingId}`
- Auth: one of:
  - none
  - API key in header `x-smarttoken`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `internal_postings_read`

Note: In order to update content of a job posting available via the Posting API, you need to re-post the job in SmartRecruiters application. The internal_postings_read OAuth scope is only required when the requested posting is internal.

## Path parameters

- `companyIdentifier` string, required
- `postingId` string, required

## Query parameters

- `sourceTypeId` string
- `sourceSubTypeId` string
- `sourceId` string

## Headers

- `accept-language` 'af' | 'am' | 'ar' | 'az' | 'bg' | 'bn' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'en' | 'en-GB' | 'es' | 'es-MX' | 'et' | 'eu' | 'fa' | 'fi' | 'fil' | 'fr' | 'fr-CA' | 'ga' | 'gl' | 'gu' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'km' | 'kn' | 'ko' | 'lo' | 'lt' | 'lv' | 'ml' | 'mn' | 'mr' | 'ms' | 'ne' | 'nl' | 'no' | 'pl' | 'pt' | 'pt-BR' | 'ro' | 'ru' | 'si' | 'sk' | 'sl' | 'sr' | 'sv' | 'sw' | 'ta' | 'te' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh-CN' | 'zh-TW' | 'zu' | 'en-AU'

## Response `200`

OK

- Posting
  - `id` string
  - `uuid` string
  - `name` string
  - `jobId` string, uuid
  - `jobAdId` string, uuid
  - `defaultJobAd` boolean
  - `applyUrl` string
  - `postingUrl` string
  - `referralUrl` string
  - `refNumber` string
  - `company` Company
    - `identifier` string
    - `name` string
  - `releasedDate` string, date-time
  - `location` PostingLocation
    - `country` string: ISO 2-letter country code
    - `region` string: This can be state, colloquial name, voivodeship or other area description
    - `city` string
    - `remote` boolean: Indicates if employees can work remotely
    - `hybrid` boolean: Indicates if employees can work in hybrid mode
    - `latitude` string
    - `longitude` string
  - `industry` Industry
    - `id` string
    - `label` string
  - `department` Department
    - `id` string
    - `label` string, required
    - `description` string
  - `function` Function
    - `id` string
    - `label` string
  - `typeOfEmployment` TypeOfEmployment
    - `id` string
    - `label` string
  - `experienceLevel` ExperienceLevel
    - `id` 'associate' | 'director' | 'entry_level' | 'executive' | 'internship' | 'mid_senior_level' | 'not_applicable'
    - `name` string
  - `customField` CustomField[]
    - `fieldId` string
    - `fieldLabel` string
    - `valueId` string
    - `valueLabel` string
  - `ref` string
  - `creator` Creator
    - `name` string
  - `jobAd` JobAdSections
    - `sections` object
      - `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` JobAdVideosSection
        - `title` string
        - `urls` string[]
  - `active` boolean
  - `visibility` 'PUBLIC' | 'INTERNAL'
  - `compensation` Compensation
    - `min` number, double, nullable
    - `max` number, double, nullable
    - `currency` string, nullable
    - `period` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', nullable

---

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