List signature requests

Signature requests from the Signed Documents report: who has signed and who is still pending.

GET https://cotlet.dev/api/v1/bamboohr/signature-requests

read

Returns requests from the Signed Documents report, newest first. Each shows the employee, the template, the date requested and the date signed, empty while pending. Filter by status, template or employee. Pages hold up to 100 requests; pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_signature_requests
NameTypeDescription
status string string 'pending', 'signed' or 'all'. Default: pending.
template_id string string Only requests for this template.
employee_id string string Only requests for this employee.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "requests": [
    {
      "request_id": "sr_7701",
      "employee_id": "412",
      "employee": "Ana Kowal",
      "template": "2026 Employee Handbook",
      "requested_at": "2026-10-09",
      "signed_at": null,
      "status": "pending"
    },
    {
      "request_id": "sr_7702",
      "employee_id": "418",
      "employee": "Tom Becker",
      "template": "2026 Employee Handbook",
      "requested_at": "2026-10-09",
      "signed_at": "2026-10-10",
      "status": "signed"
    }
  ],
  "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.