List placements

Placements, optionally of one job, with candidate, start date and status.

GET https://cotlet.dev/api/v1/jobadder/placements

read

Returns a page of placement records your JobAdder user can see, each with placement_id, job, candidate, start date and status. Pass job_id to see the placements of one job. Pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_placements
NameTypeDescription
job_id string string Only placements of this job.
limit integer integer Maximum placements to return.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/jobadder/placements \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("jobadder", "list_placements")
Node.js
const result = await cotlet.call('jobadder', 'list_placements');
CLI
cotlet call jobadder list_placements

Example response

JSON

{
  "placements": [
    {
      "placement_id": "plc_3107",
      "job": "Senior Accountant",
      "candidate": "Priya Nair",
      "start_date": "2026-12-01",
      "status": "Confirmed"
    }
  ],
  "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.