Get job

GET/api/jobs/:jobId

Returns the full job object including the description, branding fields, and counts (questions, interviews, average score across completed screens).

Path parameters

Name	Type	Required	Description
`jobId`	uuid	yes	UUID of the job. Get this from List jobs or from the dashboard URL.

Headers

Authorization header required. See Authentication.

Response

Returns a single job object. average_score is null if no completed screens have a score yet. logo_url and brand_color are null unless the recruiter customized branding (Pro).

200 OK

json

{
  "id": "f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52",
  "user_id": "9e8d7c6b-5a4f-3e2d-1c0b-a9f8e7d6c5b4",
  "title": "Senior Caregiver",
  "company_name": "Riverside Senior Living",
  "description": "We're hiring caregivers for our 80-bed memory care unit...",
  "status": "active",
  "slug": "senior-caregiver-a3f9c2",
  "share_token": "8c1e4b9d7f0a3e2b5d6c8a9f1b2e4d6c8a9f1b2e4d6c8a9f1b2e4d6c8a9f1b2e",
  "logo_url": null,
  "brand_color": null,
  "show_prelim_branding": true,
  "eu_candidates_allowed": false,
  "question_count": 6,
  "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/f4c2a1d8-9b3e-4d6a-b25f-1c0e8a7b3d52 \
  -H "Authorization: Bearer prelim_8s4kZxQv3p2nLw1HfYBgRmTcEsK9aJdN0iUyXoVbPeWzCqA"

Returns 404 Job not found if the job does not exist or belongs to a different organization.