SPspott
Jobs

List jobs

Returns a list of jobs. Uses cursor pagination.

get/vacancies

Request

Query parameters

limitinteger
Example:25

Number of jobs to return per page (min: 1, max: 50, default: 25).

cursorstring
Example:eyJtb2RpZmllZEF0IjoiMjAyNC0xMS0wNlQxMDozMDowMC4wMDBaIiwiaWQiOiJ2YWNhbmN5LTEyMyJ9

Base64-encoded cursor for pagination. Use the nextCursor value from a previous response to fetch the next page. Omit for the first page.

modifiedSincestring date-time

Filter jobs by sync watermark on or after this date. Useful for incremental synchronization. Defaults to beginning of time if not provided.

modifiedUntilstring date-time

Filter jobs by sync watermark on or before this date. Useful for bounded synchronization snapshots. If omitted, no upper bound is applied.

companyIdsstring[]

Filter jobs by company IDs.

[
  "company-123",
  "company-456"
]
candidateEmailAddressesstring[]

Filter jobs by candidate email addresses. Returns jobs that have at least one application from a candidate with a matching email.

[
  "candidate@example.com"
]
includestring[]

Optional related data to include in the response. Available options: jobBoards.

[
  "jobBoards"
]

Response

Successfully retrieved jobs. Returns items array with pagination info containing cursor for the next page.

Changes

No recorded changes to this operation across all 1 revision of this API.