You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.
List jobs
recruitment/list-jobs@1.0.114 providers
List jobs
Returns a paginated collection of your company jobs.
Input
State
Page
Page limit
Result
Jobs
Pagination
Rate limit
1.Choose a provider
2.Use ListJobs with mock in your code
Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk
Structure details
Input (object)
state
optional
The state to filter jobs with.
enum
draftpublishedclosedarchived
page
optional
Pagination cursor (obtained from `previousPage` or `nextPage`).
string
limit
optional
Maximum number of jobs returned in single page.
number
Example
Result (object)
jobs
optional
List of jobs.
list
id
required
Unique identifier of the job.
string
name
required
The name of the job.
string
description
optional
The description of the job.
string
state
optional
The state of the job.
enum
draftpublishedclosedarchived
departmentName
optional
The name of the department that opened the job.
string
requirements
optional
The requirements of the job for the candidate.
benefits
optional
The benefits of the job for the candidate.
createdAt
optional
The timestamp when was the job created in ISO8601 format.
string
pagination
optional
The pagination state.
object
previousPage
optional
Previous page cursor.
nextPage
optional
Next page cursor.
rateLimit
optional
Rate limit details.
object
bucket
optional
Different parts of API may have different rate limits.
Bucket identifies to which part of API the rate limits apply.
string
totalRequests
optional
Total requests available in the time window.
number
remainingRequests
optional
Remaining requests available in the time window.
number
remainingRequestsPercentage
optional
Remaining requests available in the time window in percents.
number
resetTimestamp
optional
Timestamp when the rate limits will reset (in Unix Timestamp format). Available only for providers without rolling rate limit window.
number