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

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
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 2 months ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=utf-8
Updated 2 months ago