Jobs

Returns a list of your jobs. The jobs are returned sorted by creation date, with the most recently created jobs appearing first.

get/jobs

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/jobs
  • Auth: HTTP bearer

Query parameters

cursorstring

An opaque pagination cursor returned in the nextCursor field of a previous response. Pass it back to fetch the next page of results.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100.

status'draft' | 'published' | 'expired' | 'archived' | 'pending_approval'

Only return jobs matching the given status. One of draft, published, expired, archived, or pending_approval (awaiting operator approval). draft does not include jobs awaiting approval.

companyIdstring

Only return jobs at the company with the given ID.

applicationUrlstring

Only return jobs matching this application URL. URLs are normalized server-side (casing, tracking params, etc.) so equivalent links match. Useful for deduplication lookups.

externalIdstring

Only return jobs with this externalId. Useful for deduplication lookups when reposting from an ATS.

Response

Successful response.

object'list' required
urlstring required
hasMoreboolean required
nextCursorstring nullable required

Example response

{
  "url": "/v1/jobs"
}

Changes