Companies

List jobs at a company

Changed on

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

get/companies/{id}/jobs

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/companies/{id}/jobs
  • Auth: HTTP bearer

Path parameters

idstring required

The company's opaque object id: the id field returned by the company endpoints (e.g. p17xq4c2b9r5gz3e8j0r6t4k7m2n9d5w). This is NOT the slug or display name; passing a slug like antler returns 404. To look up a company by name or slug, use GET /v1/companies, POST /v1/companies/search, or POST /v1/companies/find-or-create and read the returned id.

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.

Response

Successful response.

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

Example response

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

Changes