REST Services for Retrieving Job Posting Feeds

You can use the Get Job Feeds endpoint to retrieve a feed of job postings. This allows you to set up the job feed with an external job site so that your postings can be shared there without a recruiter having to post them manually.

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

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

Query string parameters to filter job posting feeds
Parameter	Description
companyName	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	The parent company name is the value configured for the Company Name for Job Feeds client property.
internalJobBoardCode	The job board reference code. The value for this parameter corresponds to the reference code configured in Recruiting Setup > Client Career Site Management. Example: CANDIDATEPORTAL.
includeActivePostingOnly	Because this is a boolean parameter, it can only be expressed as `true` or `false`: If `true`, then inactive postings are excluded from the results. If `false`, then the `lastUpdateTimeFrom` and `lastUpdateTimeTo` parameters are required.
lastUpdateTimeFrom	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	The ending 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.
datePostedFrom	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	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.

The response from this request includes the information from the relevant job postings according to the filters. Here is an example 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>
        <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,
        "ParentRequisitionId": 3,
        "HiringRate": 10.3,
        "JobType": 0,
        "TravelPercentage": 30,
        "TravelRequired": 1,
        "TelecommutePercentage": 10
    }]

Sample Code - Get Job Feeds

The following figure shows the sample code used to retrieve a job feed:

Sample code used to retrieve a job feed.

Error Codes

The following error codes can be returned:

JOBFEED_INVALID_CLIENT_PROPERTY: The Dayforce client property that controls access to this endpoint is currently not enabled. Contact the Dayforce client's system administrator to inquire about enabling the client property.
JOBFEED_QUERY_PARAMETER_NOT_FOUND: Values for the Last Update Time From or Last Update Time To parameters weren’t found. The Last Update Time From and Last Update Time To parameters are required when the Include Active Postings Only parameter is set to the value of False.
JOBFEED_INVALID_DATE_RANGE: An invalid Last Update time range was specified. The range specified between the Last Update Time From and Last Update Time To parameters must not be larger than 1 month.