# Get Job Requisition

This API allows you to retrieve job requisition details from Cornerstone Recruiting.

  • The API supports retrieving a single job requisition as well as using query filters to retrieve multiple job requisitions in a single call.
  • If you are using the lastModifiedSince query parameter, please note that this parameter does not account for changes made to job postings. It only accounts for changes made to the job requisition itself. Any changes made in the Create/Edit Job Requisition General page are accounted for by the lastModifiedSince filter.
  • The FromDate and ToDate parameters allow you to search for job requisition by initial creation date.
  • The API does not include requisition custom fields in the response. To retrieve custom fields, please use the 'Get Job Requisition Custom Field' API.
  • The API does not resolve any job ad tags to their actual values in the ExternalAd, InternalAd, and MobileAd response fields. In order to retrieve resolved job ads, please use the 'Get Job Requisition Ad Details' API. To learn more about job ad tags in Cornerstone Recruiting, please see this Online Help article. You must be logged in to your Cornerstone portal to access this article.

# Localization

The following request and response fields are localized. The API considers the language of the user associated with the OAuth 2.0 application to determine the locale for these fields.

Localized Request Parameters:

  • Statuses

If the value included in the query parameter does not match a localized value defined in your Cornerstone portal, the API will fall back on the default language of the portal to identify the value you sent in the query.

To understand this localization logic better, let's consider an example. Let's assume the following are true in your Cornerstone portal:

  • The language of the user acquiring the session token is defined as French (fr-FR)
  • The French value for requisition status of 'Open' is set as 'Ouvert'
  • The default language in your portal is defined as English (US) (en-US)

With this setup, the following three outcomes are possible:

  • Scenario 1: If you send Statuses=Ouvert in your API query parameter, the API will look for the localized requisition values in French. A matching localized value of 'Ouvert' is found and the API will return requisitions in Open status.
  • Scenario 2: If you send Statuses=Ouvrir in your API query parameter, the API will look for the localized requisition values in French. A matching localized value of 'Ouvrir' is not found. The API then looks for the value of 'Ouvrir' to be defined as a requisition status in English (US), the portal's default language. The API does not find that either because the English (US) value is defined as 'Open'. This causes the API to return an error in the response.
  • Scenario 3: If you send Statuses=Open in your API query parameter, the API will look for the localized requisition values in French. A matching localized value of 'Open' is not found. The API then looks for the value of 'Open' to be defined as a requisition status in English (US), the portal's default language. The API does find it this time and returns requisitions in Open status.

Localized Response Parameters:

  • Compensation
  • Currency
  • DefaultName
  • Division
  • EmploymentStatus
  • EmploymentType
  • ExternalAd
  • ExternalDescription
  • Grade
  • IdealQualification
  • InternalAd
  • InternalDescription
  • JobResponsibility
  • Location
  • MetaPageDesc
  • MetaPageTitle
  • MinimumQualification
  • MobileAd
  • Position
  • Priority
  • PriorityName
  • RequisitionTemplate
  • Title
  • Status
  • CareerSite>Name
  • AdditionalLocations>Location

Permission Required: Requisition: View/Edit Salary Range
This permission is only required if you wish to retrieve the salary range using this API. If the user associated with your OAuth 2.0 application does not have this permission, the RangeHigh and RangeLow fields in the API's response will contain the value zero.

OAuth 2.0 Scope: jobrequisition:read