Skip to main content
SmartRecruiters

A Job Board API workflow

 

This article describes what methods are used to grab customers’ postings and what takes place in the API.

 

In order to test the entire Posting workflow, you would need:

 

 

Contact the Partner Operations Consultant you are already working with to receive common endpoint values (industry, function, type of employment, etc) and/or to have some test jobs in your feed to test the workflow.


 

There are 2 ways to grab customers’ postings:

 

 

Documentation Overview

Live Swagger

 

Check the feed periodically for new postings ("Pending" status)

 

Get all "Pending" Jobs

 

GET /publications



 

 

Request

Sample Response


 

Get a particular Job's details      

 

GET /publications/{postingId}



 

 

Once the job is posted move to "Active" 

 

PUT /publications/{postingId}


 

{

"comment": "string",

"liveUrl": "string",

"status": "Active"

}

 

 


 

Get all "toUnpost" Jobs                 

 

GET /publications

 


 

Once the job is unposted - unpost it on your end and move to Inactive                

 

PUT /publications/{postingId}

 

{

"comment": "string",

"liveUrl": "string",

"status": "Inactive"

}

 


 

 XML feed (depreciated and in the maintenance mode only)    

 

Here is the sample XML Feed: https://api.smartrecruiters.com/feed/v1/postings?token=


 

Once the customer post jobs through your offer, they go to your feed in real-time. Once the job is unposted, it is no longer visible in the feed.