/requisitions

Returns a collection of your account requisitions. Required scope: r_requisitions. Accessible with all token types.

📘

Timestamp parameters input format

Supported input formats for the timestamp fields created_after & updated_after are:

  • ISO8601 e.g. 20150708T115616Z
  • Unix time (e.g. 1436356721)

Results

Calling the /requisitions endpoint will return a collection of the defined requisitions sorted by the time inserted on system, in ascending order (older requisitions come first).

By default results are limited to 50. The limit can be updated via the request parameter limit. The value specified cannot be more than 100.

keydescription
requisitionsarray of the requisitions
pagingIncludes the next URL pointing to the next results page, in case there are more results than the provided limit

Each requisition will have the following keys:

keytypedescription
idstringThe requisition identifier
codestringThe code of the requisition
jobobjectThe job of the requisition
job.idstringThe ID of the job
job.titlestringThe title of the job
departmentobjectThe department of the requisition
department.idstringThe ID of the department
department.namestringThe name of the department
locationobjectThe location of the requisition
location.location_strstringThe string representation of the location
location.countrystringThe country full name
location.country_codestringThe 2-letter ISO code of the country
location.regionstringThe region of the location
location.region_codestringThe code of the region of the location
location.citystringThe city of the location
location.zip_codestringThe ZIP code of the location
requesterobjectThe requester of the requisition
requester.idstringThe ID of the requester
requester.namestringThe name of the requester
hiring_managerobjectThe hiring manager of the requisition
hiring_manager.idstringThe ID of the hiring manager
hiring_manager.namestringThe name of the hiring manager
ownerobjectThe owner of the requisition
owner/idstringThe ID of the owner
owner/namestringThe name of the owner
plan_datestringThe plan date of the requisition in YYYY-MM-DD format (ie 2022-01-31)
start_datestringThe start date of the requisition in YYYY-MM-DD format (ie 2022-01-31)
salary_rangeobjectThe salary range of the requisition.
salary_range.fromnumberThe minimum salary of the requisition
salary_range.tonumberThe maximum salary of the requisition
salary_range.frequencystringThe frequency of the salary range. Can be one of hour, day, week, month, year.
salary_range.currency_isostringThe 3-letter ISO code of the currency (ie EUR, USD).
salaryobjectThe salary of the requisition. Only exists for filled requisitions.
salary.amountnumberThe amount of the salary
salary.frequencystringThe frequency of the salary range. Can be one of hour, day, week, month, year.
salary.currency_isostringThe 3-letter ISO code of the currency (ie EUR, USD).
candidate_idstringThe ID of the candidate. Only exists for filled and reserved requisitions.
employment_typestringThe employment type. Can be one of Full-time, Part-time, Contract, Temporary, Other.
reasonstringThe reason for the requisition. Can be one of new_hire, replacement, backfill.
statestringThe state of the requisition. Can be one of processing, draft, pending, approved, open, filled, rejected, cancelled, reserved, on_hold.
requisition_attributesarrayThe attributes of the requisition. For the keys of each requisition attribute check the table below.
approval_groupsarrayThe approval groups of the requisition, in the order of the approval workflow. For the keys of each approval group check the table below.

Each requisition_attributes contains the following keys

keytypedescription
namestringThe name of the requisition attribute
value.bodystring, number or booleanThe value of the requisition attribute. It's type varies depending on the type of the requisition attribute:

string if the type is of case short text, free text or date
number if the type is numeric
boolean if the type is boolean
value.choicesarrayArray of the labels of the selected choices
dataobjectThe value data (only for salary requisition attributes)
data.amountnumberThe amount of salary
data.frequencystringThe frequency of the salary. Can be one of hour, day, week, month, year.
data.currency_isostringThe 3-letter ISO code of the currency (ie EUR, USD).

Each approval group contains the following keys

keytypedescription
idstringThe approval group identifier
approversarrayArray of the approvers of the approval group for the specific requisition. For groups with a decision (positive or negative), only that approver will be present. For groups without a decision, all the approvers will appear.
approvers.idstringThe identifier of the approver
approvers.namestringThe name of the approver
approvers.decisionstringThe decision of the approver (only if the approver has submitted a decision). If present, it is one of approved, rejected.
Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!