---
title: "Get a list of postings"
method: GET
path: "/publications"
tags: ["feed"]
---

# Get a list of postings

`GET /publications`

## Request

- Base URL: `https://api.smartrecruiters.com/feed`
- URL: `https://api.smartrecruiters.com/feed/publications`
- Auth: API key in header `X-SmartToken`

Get job postings published to your job board.  
You must pass authentication token through **X-SmartToken** HTTP header.

By default, this endpoint will return only postings created in the last 30 days with the status _Pending_. Use additional parameters to control which postings are returned.

## Query parameters

- `updatedAfter` string
- `status` string[]
- `offset` string
- `limit` string

## Response `200`

Postings successfully returned

- FeedPublication
  - `Provider` string
  - `offset` string: int32
  - `limit` string: int32
  - `totalFound` string: int64
  - `jobs` FeedJobAd[]
    - `id` string
    - `uuid` string
    - `name` string
    - `refNumber` string
    - `status` string
    - `jobAdUrl` string
    - `liveUrl` string
    - `applyUrl` string
    - `comment` string
    - `postedDate` string
    - `location` FeedLocation
      - `city` string
      - `region` string
      - `regionCode` string
      - `country` string
      - `countryCode` string
      - `address` string
      - `zipCode` string
      - `longitude` string
      - `latitude` string
      - `remote` boolean
    - `company` FeedCompany
      - `cid` string
      - `name` string
      - `identifier` string
    - `brand` FeedBrand
      - `id` string
      - `name` string
      - `logo` string
    - `creator` FeedUser
      - `firstName` string
      - `lastName` string
      - `email` string
    - `budget` FeedBudgeting
      - `programmatic` FeedBudget
        - `price` string
    - `compensation` FeedCompensation
      - `minimum` string
      - `maximum` string
      - `currency` string
      - `period` string
    - `industry` FeedDictionaryEntry
      - `id` string
      - `label` string
    - `function` FeedDictionaryEntry
      - `id` string
      - `label` string
    - `experienceLevel` FeedDictionaryEntry
      - `id` string
      - `label` string
    - `typeOfEmployment` FeedDictionaryEntry
      - `id` string
      - `label` string
    - `customFields` CustomField[]
      - `fieldId` string
      - `fieldLabel` string
      - `valueId` string
      - `valueLabel` string
    - `videoUrls` string[]
    - `languageCode` string
    - `jobAd` FeedJobAdDetails
      - `companyDescription` string
      - `jobDescription` string
      - `qualifications` string
      - `additionalInformation` string

## Other responses

- `401`: Unauthorized
- `404`: Not found

---

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