List jobs

GET/api/jobs

Returns an array of every job in your organization, newest first. Each item is a summary with interview counts and average score; fetch a single job with Get job if you need the full description and question count.

Query parameters

Name	Type	Required	Description
`status`	string	no	Filter by status. One of `active`, `paused`, `archived`.
`search`	string	no	Case-insensitive substring match against title.

Headers

Authorization header required. See Authentication.

Response

Returns an array of job summaries. average_score is null until at least one candidate completes a screen.

200 OK

json

[
  {
    "id": "f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52",
    "title": "Senior Caregiver",
    "company_name": "Riverside Senior Living",
    "status": "active",
    "slug": "senior-caregiver-a3f9c2",
    "share_token": "8c1e4b9d7f0a3e2b5d6c8a9f1b2e4d6c8a9f1b2e4d6c8a9f1b2e4d6c8a9f1b2e",
    "interview_count": 47,
    "average_score": 7.4,
    "created_at": "2026-04-08T13:42:11.001Z",
    "updated_at": "2026-05-20T09:15:38.220Z"
  }
]

Example request

curl

curl "https://api.prelim.chat/api/jobs?status=active" \
  -H "Authorization: Bearer prelim_8s4kZxQv3p2nLw1HfYBgRmTcEsK9aJdN0iUyXoVbPeWzCqA"