Get job pipeline
One job with its hiring team and pipeline stages, each with the number of candidates.
GET https://cotlet.dev/api/v1/recruiterflow/jobs/{job_id}
read
Returns one job: title, client company, status, visibility, Account Manager and Recruiter(s), and the stages of its interview plan in order. Each stage has its name, its Stage Category (Sourced, Company Submission, Interview, Hired, Rejected) and the candidates in it. disqualified counts candidates removed from this job. Use the stage names in list_job_candidates and move_candidate_stage.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job id from list_jobs. |
Request
curl https://cotlet.dev/api/v1/recruiterflow/jobs/job_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recruiterflow", "get_job", {"job_id":"job_8c41d2"})const result = await cotlet.call('recruiterflow', 'get_job', {"job_id":"job_8c41d2"});cotlet call recruiterflow get_job --data '{"job_id":"job_8c41d2"}'Example response
{
"job_id": "48213",
"title": "Senior Backend Engineer",
"company": "Northwind Labs",
"status": "open",
"visibility": "external",
"hiring_team": {
"account_manager": "Jordan Pike",
"recruiters": [
"Dana Reyes"
]
},
"stages": [
{
"name": "Sourced",
"category": "Sourced",
"candidates": 7
},
{
"name": "Phone Screen",
"category": "Interview",
"candidates": 4
},
{
"name": "Submitted",
"category": "Company Submission",
"candidates": 2
},
{
"name": "Hired",
"category": "Hired",
"candidates": 1
}
],
"disqualified": 3
}