List jobs
Jobs of your agency with company, contact, owner, status and sourcing dates.
GET https://cotlet.dev/api/v1/vincere/jobs
read
Lists jobs as Vincere shows them in the Jobs table, one page at a time; pass next_cursor back as cursor for the next page. status filters open or closed jobs. query matches the job title or company name. Use job_id from here in the other tools. Only open jobs can take new shortlists.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open or closed. Default: all. |
| query string | string | Part of the job title or company name. |
| limit integer | integer | How many jobs to return on one page. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/vincere/jobs \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("vincere", "list_jobs")const result = await cotlet.call('vincere', 'list_jobs');cotlet call vincere list_jobsExample response
{
"jobs": [
{
"job_id": "1042",
"title": "Senior Java Developer",
"company": "Brightline Tech",
"contact": "Alex Reed",
"owner": "Dana Fox",
"status": "open",
"job_type": "Permanent",
"sourcing_close_date": "2026-11-30"
},
{
"job_id": "1047",
"title": "Data Engineer",
"company": "Northwind Systems",
"contact": "Sam Okafor",
"owner": "Dana Fox",
"status": "open",
"job_type": "Contract",
"sourcing_close_date": "2026-12-15"
}
],
"next_cursor": null
}