---
title: "Lists active postings published by given company"
method: GET
path: "/v1/companies/{companyIdentifier}/postings"
tags: ["postings"]
---

# Lists active postings published by given company

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

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/v1/companies/{companyIdentifier}/postings`
- 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`

Lists active postings published by given company. Return PostingList. The internal_postings_read OAuth scope is only required when the destination query parameter is INTERNAL or INTERNAL_OR_PUBLIC.

## Path parameters

- `companyIdentifier` string, required

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `destination` 'PUBLIC' | 'INTERNAL' | 'INTERNAL_OR_PUBLIC'
- `locationType` string[]
- `country` string
- `region` string
- `city` string
- `department` string
- `jobAdId` string, uuid
- `language` JobAdLanguageCode[]
- `releasedAfter` string, date-time
- `customField` object

## 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

- PostingList
  - `totalFound` integer
  - `limit` integer
  - `offset` integer
  - `content` PostingItem[]
    - `id` string
    - `uuid` string
    - `name` string
    - `jobAdId` string, uuid
    - `defaultJobAd` boolean
    - `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
    - `language` Language
      - `code` string
      - `label` string
      - `labelNative` string
    - `visibility` 'PUBLIC' | 'INTERNAL'

---

[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)