Get a job
Read one job: its hiring stages, closing date and application form questions.
GET https://cotlet.dev/api/v1/homerun/jobs/{job_id}
read
Returns the job state and visibility, the hiring stages in order, the closing date if one is set and the questions of the application form. Stage names are specific to each job, so read them here before moving anyone.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job ID from list_jobs. |
Request
curl https://cotlet.dev/api/v1/homerun/jobs/job_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY" result = client.call("homerun", "get_job", {"job_id":"job_8c41d2"}) const result = await cotlet.call('homerun', 'get_job', {"job_id":"job_8c41d2"}); cotlet call homerun get_job --data '{"job_id":"job_8c41d2"}' Example response
{
"job_id": "job_3b7e91",
"title": "Customer Success Manager",
"state": "active",
"visibility": "public",
"closing_date": null,
"stages": [
"Application",
"Phone call",
"Interview",
"Offer"
],
"application_questions": [
"Why do you want this role?",
"How many years of customer-facing experience do you have?"
]
}