CleverStaff API

Candidates and vacancies applications

Use the CleveStaff API to place your active vacancies on a website. Once you use the CleverStaff API, it can send the candidates’ applications for your positions directly to your CleverStaff account.

NOTE: CleverStaff API available only for ‘Teamwork’, ‘Corporate’ and ‘Enterprise’ plans users.

Here is a functional scope of the CleverStaff API:

  • #1
    getVacancies
    allows to get a full list of active vacancies from your CleverStaff account.
  • #2
    getVacancyById
    allows to get a vacancy data via its Id
  • #3
    sendApplication
    allows to send the candidates’ data (resume and contacts) directly into your CleverStaff account when they apply for a open position on your website.

1. Get a full list of active vacancies

Get a full list of active vacancies via the following request:

https://cleverstaff.net/hr/public/getVacancies?alias=greenwood

greenwood -- is an alias generated according to the company name in your CleverStaff account. You can change it at ‘Comapny’ >> ‘Company settings’.

{ "vacancyId":"1d84691a84074156a3bea6bf178d4db7", Vacancy Id
"orgId":"431b205ec6b34c51a270b9beac879dee", Company Id
"localId":"LedxEx", LocalId to get a vacancy via link
"position":"General Manager", Position name
"status":"inwork", Vacancy status
"experience":"5", Experience (years)
"employmentType":"Full time", Employment type
"langs":"English Elementary", Language level
"ageFrom":30, Age: from
"ageTo":40, Age: to
"currency":"USD", Salary currency
"salaryFrom":1000, Salary From
"salaryTo":2000, Salary To
"dc":1462435076638, "region2":{ Date when vacancy was created
"regionId":"9500507949a8d4c45adf665ab50da70d-76891652", "orgId":"431b205ec6b34c51a270b9beac879dee", "lang":"en", "country":"Kazakhstan", "lat":48.019573, "lng":66.92368, "fullName":"Kazakhstan", "googlePlaceId":{ "googlePlaceId":"ChIJR6n87AcQqTgRGw6z5C-Ee18", "countryEn":"Kazakhstan", "countryRu":"Казахстан", "countryUa":"Казахстан" }, "displayCountry":"Kazakhstan", "displayFullName":"Kazakhstan" },

Country (English)

Country (Russian)

Country (Ukrainian)

"clientName":"Sales Department"
},
Name of company / client / project

2. Get a vacancy data via Id

Get a vacancy data via the following request:

https://cleverstaff.net/hr/public/getVacancy?host=&id=LedxEx

LedxEx equals the localId

{ "vacancyId":"1d84691a84074156a3bea6bf178d4db7", Vacancy Id
"orgId":"431b205ec6b34c51a270b9beac879dee", Company Id
"localId":"LedxEx", LocalId to get a vacancy via link
"position":"General Manager", Position name
"status":"inwork", Vacancy status
"experience":"5", Experience (years)
"employmentType":"Full time", Employment type
"langs":"English Elementary", Language level
"ageFrom":30, Age: from
"ageTo":40, Age: to
"currency":"USD", Salary currency
"salaryFrom":1000, Salary From
"salaryTo":2000, Salary To
"descr":"<p>&nbsp;
&nbsp;&nbsp;</p>\n<p>&nbsp;</p>\n<p> &nbsp;</p>\n<p>&nbsp;</p>\n<p>&nbsp;</p>\n<p>&nbsp; </p>\n<p>&nbsp;</p>\n<p>&nbsp;</p>\n<p>&nbsp;
</p>\n<p> &nbsp;</p>\n<p>&nbsp;</p>",
Vacancy description
"dc":1462435076638, "region2":{ Date when vacancy was created
"regionId":"9500507949a8d4c45adf665ab-50da70d76891652", "orgId":"431b205ec6b34c51a270b9beac879dee",
"lang":"en",
"country":"Kazakhstan",
"lat":48.019573,
"lng":66.92368,
"fullName":"Kazakhstan",
"googlePlaceId":{ "googlePlaceId":"ChIJR6n87AcQqTgRGw6z5C-Ee18", "countryEn":"Kazakhstan",
"countryRu":"Казахстан",
"countryUa":"Казахстан"
},
"displayCountry":"Kazakhstan", "displayFullName":"Kazakhstan"
},

Country (English)

Country (Russian)

Country (Ukrainian)

"clientName":"Sales Department"
},
Name of company / client / project

3. Application for a vacancy

A candidate can apply for a vacancy via the following request:

https://cleverstaff.net/i#/pv/LedxEx

where LedxEx equals the localId.

Before sending a CV, it should be added via the following request:

https://cleverstaff.net/hr/public/addFile

You will get a file ID which you will be able to send with a response to the following request:

https://cleverstaff.net/hr/public/sendApplication

{
"name":"First Name",
Name
"lastName":"Second Name", Second Name
"phone":"0123456789", Phone number
"message":"Message (optional)", Message (optional)
"vacancyId":"1d84691a840741-56a3bea6bf178d4db7", Vacancy ID
"fileId":"[{\"name\":\"test-Chezhresume1.docx\", \"attId\":\"176957d7b5ba4362827-633a4c1ae2552\"}]", File name | File Id generates via the following request: https://dev.cleverstaff.net/hr/public/addFile
"email":"email@mail.com", Email
"lang":"ru"
}
Language