List applications

Applications of a job with candidate, stage, status and days in stage, newest update first.

GET https://cotlet.dev/api/v1/ashby/jobs/{job_id}/applications

read

Lists applications of one job, filtered by stage name and by how long ago they were last updated. Active applications by default; set archived to true to read archived ones with their reasons. Pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_applications
NameTypeDescription
job_id string required string Job ID from list_jobs.
stage string string Stage name as in the job's interview plan, for example 'Application Review'.
updated_before string string ISO date. Only applications not updated since then.
archived boolean boolean true lists archived applications with their archive reason. Default: false.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "applications": [
    {
      "application_id": "7d2e4c18-5f3a-4b09-8a61-c0e9d3f1a742",
      "candidate": "Chris Nowak",
      "candidate_id": "a6d30b95-7e12-4c48-8f05-2c91e4b7d3a0",
      "stage": "Application Review",
      "status": "Active",
      "days_in_stage": 19
    },
    {
      "application_id": "3f60c8d1-9a27-4e53-b184-d7a05e2c9b36",
      "candidate": "Mei Tanaka",
      "candidate_id": "c82e5f17-0b94-4a6d-93e8-5f1a7d0c4b29",
      "stage": "Application Review",
      "status": "Active",
      "days_in_stage": 16
    }
  ],
  "next_cursor": null
}

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.