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 ‘Company’ >> ‘Company settings’.

{
"localId":"LedxEx",
LocalId to get a vacancy via link
"position":"General Manager", Position name
"status":"inwork", Vacancy status
"employmentType":"Full time", Employment type
"langs":"English Elementary", Language level
"currency":"USD", Salary currency
"salaryFrom":1000, Salary From
"salaryTo":2000, Salary To
"lang":"en", "country":"Kazakhstan", "lat":48.019573, "lng":66.92368, "fullName":"Kazakhstan", "displayCountry":"Kazakhstan", "displayFullName":"Kazakhstan"
}
Vacancy location

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

{
"localId":"LedxEx",
LocalId to get a vacancy via link
"position":"General Manager", Position name
"status":"inwork", Vacancy status
"employmentType":"Full time", Employment type
"currency":"USD", Salary currency
"salaryFrom":1000, Salary From
"salaryTo":2000, Salary To
"lang":"en",
"country":"Kazakhstan",
"lat":48.019573,
"lng":66.92368,
"fullName":"Kazakhstan",
"displayCountry":"Kazakhstan", "displayFullName":"Kazakhstan"
}
Vacancy location

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