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

Parameters: get_job
NameTypeDescription
job_id string required string Job ID from list_jobs.

Request

cURL
curl https://cotlet.dev/api/v1/homerun/jobs/job_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("homerun", "get_job", {"job_id":"job_8c41d2"})
Node.js
const result = await cotlet.call('homerun', 'get_job', {"job_id":"job_8c41d2"});
CLI
cotlet call homerun get_job --data '{"job_id":"job_8c41d2"}'

Example response

JSON

{
  "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?"
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.