API Reference

Lists active postings published by given company

get
https://api.smartrecruiters.com/v1/companies//postings

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identifier of a company

Query Params
string

full-text search query based on a job title, location

integer

number of elements to return. max value is 100

integer

number of elements to skip while processing result

string
enum

Filter indicating which postings to return:

  • PUBLIC: response will include ONLY public postings
  • INTERNAL: response will include ONLY internal postings
  • INTERNAL_OR_PUBLIC: response will include internal postings or public postings, but not both for a single job. If a job has both types of postings, only internal postings will be returned. NOTE: when selected, all postings, internal and public, will be treated as internal. Among other things, this means that screening questions will not be displayed, and candidates will be marked with the EMPLOYEE label.
Allowed:
locationType
array of strings

Filter indicating which postings to return:

  • REMOTE: response will include ONLY postings with remote location type
  • HYBRID: response will include ONLY postings with hybrid location type
  • ONSITE: response will include ONLY postings with onsite location type
  • ANY: response will include ANY location type
locationType
Allowed:
string

country code filter (part of the location object)

string

region filter (part of the location object)

string

city filter (part of the location object)

string

department filter (department id)

uuid

job ad id filter

language
array of objects

Job ad language; accepts 2-letter ISO 639-1 language code; multiple codes can be provided, separated by comma (",")
Exceptions to the language code ISO format:

  • "en-GB" - "English - English (UK)"
  • "fr-CA" - "French - français (Canada)"
  • "pt-BR" - "Portugal - português (Brasil)"
  • "pt-PT" - "Portugal - português (Portugal)"
  • "zh-TW" - "Chinese (Traditional) - 中文 (香港)"
  • "zh-CN" - "Chinese (Simplified) - 中文 (简体)"
language
date-time

Released after filter (ISO8601-formatted)
Format: yyyy-MM-ddTHH:mm:ss.SSSZZ

customField
object

Filters postings by custom fields. Multiple custom field values can be provided, separated by comma (",").
Format: custom_field.CUSTOM_FIELD_ID=CUSTOM_FIELD_VALUE1_ID,CUSTOM_FIELD_VALUE2_ID

Headers
string
enum

Language of translation

Response

Updated 4 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=utf-8

Updated 4 months ago

Did this page help you?