RESTful Get Job Postings

Dayforce RESTful Web Services Developer Guide
Version
R2025.2.1
RESTful Get Job Postings

Get Job Postings is used to share career site postings in Dayforce with external job boards. Job board providers use this endpoint to obtain job posting data.

The Allow Candidates and Job Application Sourcing from External Job Boards client property in Recruiting Setup > Client Properties is used to determine if authorized access to the RESTful GET Job Postings request is allowed, along with access to candidate profiles, job applications, and disposition data. This request requires basic authentication. That is, a user account with role feature access in the Features tab of System Admin > Roles to HCM Anywhere > Web Services > Patch/Post Candidate Sourcing and Job Application Sourcing.

This call URL doesn't allow any information to be posted back. To find out how to add RESTful API endpoints to enable candidate information to be returned, see RESTful Add Candidate Profile and Application Data.

Overview

The call URL is constructed by adding keyword "JobFeeds" to the base URL. Optional parameters can be added to the URL as required:

https://www.dayforcehcm.com/api/CompanyName/V1/JobFeeds

Below is an example of the URL with the DatePostedTo and CompanyName parameters being used:

GET Request - http://www.dayforcehcm.com/[CompanyName]/v1/JobFeeds?DatePostedTo=2019-06-13T00:00:00&CompanyName=XYZ%20Co

Parameters

You can use the parameters listed below to refine the query. All of the parameters listed below are optional.

companyName (string)

  • Name of the company.
  • The company name is the value of the company name override from the client career site configuration page. If company name override isn’t available then it's the value of the parent company name.

parentCompanyName (string)

  • Name of the parent company.
  • The parent company name is the value configured for the Company Name for Job Feeds client property in Recruiting Setup > Client Properties.

internalJobBoardCode (string)

  • The job board reference code. Example: CANDIDATEPORTAL.
  • The value for this parameter corresponds to the reference code configured in Recruiting Setup > Client Career Site Management.

includeActivePostingOnly (Boolean)

  • If true, then inactive postings are excluded from the results.
  • If false, then the lastUpdateTimeFrom and lastUpdateTimeTo parameters are required.
  • Because this is a Boolean value, it can only be expressed as true or false.

lastUpdateTimeFrom (datetime)

  • The starting timestamp of the last updated job posting.
  • This parameter is required when the includeActivePostingOnly is set to false.
  • The difference between the lastUpdateTimeFrom and lastUpdateTimeTo parameters cannot exceed one month.
  • Datetime value should be expressed as yyyy-mm-ddThh:mm:ss where T is a separator used between the date and time. For example, 2017-01-01T13:24:56.

lastUpdateTimeTo (datetime)

  • The ending timestamp of the last updated job posting.
  • This parameter is required when the includeActivePostingOnly parameter is set to false.
  • The difference between the lastUpdateTimeFrom and lastUpdateTimeTo parameters cannot exceed one month.
  • Datetime value should be expressed as yyyy-mm-ddThh:mm:ss where T is a separator used between the date and time. For example, 2017-01-01T13:24:56.

DatePostedFrom (datetime)

  • The starting timestamp of the job posting date.
  • Datetime value should be expressed as yyyy-mm-ddThh:mm:ss where T is a separator used between the date and time. For example, 2017-01-01T13:24:56.

DatePostedTo (datetime)

  • The ending timestamp of the job posting date.
  • Datetime value should be expressed as yyyy-mm-ddThh:mm:ss where T is a separator used between the date and time. For example, 2017-01-01T13:24:56.

QuestionnairesURL (URL)

  • Used to retrieve questionnaire questions for a particular job posting.
  • Candidate data can be sent with or without the responses to these questionnaires.
  • This field contains the URL required to use the GET Job Posting Questionnaires endpoint for a particular job posting.
  • See the examples above for the URL format.

CandidateApplicationPostUrl (URL)

  • Used to send candidate data and applications.
  • This is the general URL used for all POST Candidate Sourcing requests.
  • Candidate data can be submitted via this POST endpoint with or without specifying a job posting. If no job posting is specified in the request body, the candidate data is imported into Dayforce for later use and a candidate profile will be created for the candidate.
  • See the examples above for the URL format.

Response

The response is in JSON or XML format depending on the request header. If the request header contains "Accept = application/xml" then the response format will be XML. Otherwise it will be in JSON format. Below there is an example of a response in XML and in JSON.

Example XML Response

<ArrayOfJob xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Job>
        <Title>
            <![CDATA[Store 110 - Accessories Associate]]>
        </Title>
        <Description>
            <![CDATA[Retail Salesperson Job Purpose: Serves customers by helping them select products.
Retail Salesperson Job Duties: - Welcomes customers by greeting them; offering them assistance. - Directs customers by escorting them to racks and counters; suggesting items. - Advises customers by providing information on products. - Helps customer make selections by building customer confidence; offering suggestions and opinions. - Documents sale by creating or updating customer profile records. - Processes payments by totaling purchases; processing checks, cash, and store or other credit cards. - Keeps clientele informed by notifying them of preferred customer sales and future merchandise of potential interest. - Contributes to team effort by accomplishing related results as needed.]]>
        </Description>
        <ClientSiteName>
            <![CDATA[Client Careers Site]]>
        </ClientSiteName>
        <ClientSiteXrefCode>
            <![CDATA[CANDIDATEPORTAL]]>
        </ClientSiteXrefCode>
        <CompanyName>
            <![CDATA[XYZ Co.]]>
        </CompanyName>
        <ParentCompanyName>
            <![CDATA[XYZ Co.]]>
        </ParentCompanyName>
        <JobDetailsUrl>
            <![CDATA[http://localhost:51009/en-US/DFLocal/Posting/View/17]]>
        </JobDetailsUrl>
        <ApplyUrl>
            <![CDATA[https://prdemo.dayforcehcm.com/CandidatePortal/en-US/prdemo2/JobPosting/Job?jobId=17]]>
        </ApplyUrl>
        <City>
            <![CDATA[San Francisco]]>
        </City>
        <State>
            <![CDATA[CA]]>
        </State>
        <Country>
            <![CDATA[USA]]>
        </Country>
        <PostalCode>
            <![CDATA[30009]]>
        </PostalCode>
        <Education>
            <![CDATA[Master’s Degree]]>
        </Education>
        <JobFunction>
            <![CDATA[General and Operations Manager]]>
        </JobFunction>
        <EmploymentIndicator>
            <![CDATA[Contractor]]>
        </EmploymentIndicator>
        <DatePosted>2014-06-13T00:00:00</DatePosted>
        <LastUpdated>2014-06-13T17:06:44.16</LastUpdated>
        <ReferenceNumber>17</ReferenceNumber>
        <CultureCode>"en-US"</CultureCode>
	<ParentRequisitionCode>3</ParentRequisitionCode>
        <MinHiringRate xsi:nil="true" />
        <MaxHiringRate xsi:nil="true" />
        <HiringRate>10.30000</HiringRate>
        <JobType>0</JobType>
        <TravelPercentage>30</TravelPercentage>
        <TravelRequired>1</TravelRequired>
        <TelecommutePercentage>10</TelecommutePercentage>
    </Job></ArrayOfJob>

Example JSON Response

   [{
        "Title": "Store 110 - Accessories Associate",
        "Description": "Sample desc",
        "ClientSiteName": "Client Careers Site",
        "ClientSiteXrefCode": "CANDIDATEPORTAL",
        "CompanyName": "XYZ Co.",
        "ParentCompanyName": "XYZ Co.",
        "JobDetailsUrl": "http://localhost:51009/en-US/DFLocal/Posting/View/17",
        "ApplyUrl": "https://prdemo.dayforcehcm.com/CandidatePortal/en-US/prdemo2/JobPosting/Job?jobId=17",
        "City": "San Francisco",
        "State": "CA",
        "Country": "USA",
        "PostalCode": "30009",
        "Education": "Master’s Degree",
        "JobFunction": "General and Operations Manager",
        "EmploymentIndicator": "Contractor",
        "DatePosted": "2014-06-13T00:00:00",
        "LastUpdated": "2014-06-13T17:06:44.16",
        "ReferenceNumber": 17,
	 "CultureCode": "en-US",
        "ParentRequisitionCode": 3,
        "HiringRate": 10.3,
        "JobType": 0,
        "TravelPercentage": 30,
        "TravelRequired": 1,
        "TelecommutePercentage": 10
    }]