Get a job

GET

https://api.confirm.global/api/v1/jobs/:jobId

GET

/api/v1/jobs/:jobId

$ curl https://api.confirm.global/api/v1/jobs/jobId \
>      -H "Authorization: Bearer <token>"

1 {
2   "id": "string",
3   "org_id": "string",
4   "title": "string",
5   "description": "string",
6   "location": "string",
7   "location_address": "string",
8   "location_city": "string",
9   "location_state": "string",
10   "postal_code": "string",
11   "location_type": "string",
12   "department": "string",
13   "employment_type": "string",
14   "status": "draft",
15   "salary_range_min": 1.1,
16   "salary_range_max": 1.1,
17   "salary_period": "string",
18   "auto_screen": true,
19   "agent_config_id": "string",
20   "candidates_screened": 1,
21   "qualified_count": 1,
22   "hired_count": 1,
23   "created_at": "2024-01-15T09:30:00Z",
24   "updated_at": "2024-01-15T09:30:00Z",
25   "stats": {},
26   "recent_applications": [
27     {
28       "application_id": "string",
29       "org_id": "string",
30       "candidate_id": "string",
31       "job_id": "string",
32       "status": "applied",
33       "score": 1.1,
34       "applied_at": "2024-01-15T09:30:00Z",
35       "evaluation_status": "string",
36       "evaluation_sent_at": "2024-01-15T09:30:00Z",
37       "evaluation_completed_at": "2024-01-15T09:30:00Z",
38       "candidates": {
39         "candidate_id": "string",
40         "org_id": "string",
41         "first_name": "string",
42         "last_name": "string",
43         "email": "string",
44         "phone": "string",
45         "address_line1": "string",
46         "address_line2": "string",
47         "city": "string",
48         "state": "string",
49         "postal_code": "string",
50         "country": "string",
51         "source": "string",
52         "applications": [
53           null
54         ],
55         "created_at": "2024-01-15T09:30:00Z",
56         "updated_at": "2024-01-15T09:30:00Z"
57       },
58       "created_at": "2024-01-15T09:30:00Z",
59       "updated_at": "2024-01-15T09:30:00Z"
60     }
61   ]
62 }

Returns a job with summary stats and its most recent applications.

Authentication

AuthorizationBearer

Supabase-issued user JWT. Send as Authorization Bearer header. Dedicated API keys are planned for a future release.

Path parameters

jobIdstringRequiredformat: "uuid"

Response

Job detail.

idstringOptionalformat: "uuid"

org_idstringOptionalformat: "uuid"

titlestringOptional

descriptionstringOptional

locationstringOptional

location_addressstring or nullOptional

location_citystring or nullOptional

location_statestring or nullOptional

postal_codestring or nullOptional

location_typestring or nullOptional

onsite, hybrid, or remote.

departmentstring or nullOptional

employment_typestringOptional

e.g. full-time, part-time.

statusenumOptional

salary_range_mindouble or nullOptional

salary_range_maxdouble or nullOptional

salary_periodstring or nullOptional

auto_screenbooleanOptional

agent_config_idstring or nullOptionalformat: "uuid"

candidates_screenedintegerOptional

qualified_countintegerOptional

hired_countintegerOptional

created_atdatetimeOptional

updated_atdatetimeOptional

statsmap from strings to anyOptional

Aggregate counts for this job.

recent_applicationslist of objectsOptional

Errors

401

Unauthorized Error

404

Not Found Error