List signing requests

GET /api/v1/signing-requests

Newest first. Needs the read permission.

Permission	read
MCP tool	list_signing_requests

Request

Query parameters

Name	Type	Required	Description
cursor	string	No	The next_cursor of the previous page.

Responses

Status	Meaning
200	A page of signing requests.
401	No key, or a key that is unknown, expired or revoked, or whose creator is no longer an owner or admin.
403	The key lacks the permission, or it is an API key and the workspace isn't on Teams & Platform.
429	More than 120 calls a minute through this key, more than 2000 from one network address (for IPv6, its /56 block) across all keys, or a limit on sending reached: the key's daily sends, the plan's or a recipient's daily requests, or the workspace's waiting approvals.

Errors share one shape, { "message": "…" }: see Errors and rate limits.

200 body

Field	Type	Description
signing_requests	array of objects	—
signing_requests[].id	string (uuid)	—
signing_requests[].title	string	—
signing_requests[].status	string	—
signing_requests[].created_at	string (date-time) or null	—
signing_requests[].sent_at	string (date-time) or null	—
signing_requests[].completed_at	string (date-time) or null	—
signing_requests[].recipients_total	integer	—
signing_requests[].recipients_signed	integer	—
next_cursor	string or null	—

Example

{
  "signing_requests": [
    {
      "id": "c3e9a7b1-2d4f-4a6c-8e1b-5f7d9a2c4e6b",
      "title": "Mutual NDA — Acme",
      "status": "sent",
      "created_at": "2026-11-03T16:20:00.000Z",
      "sent_at": "2026-11-03T16:41:12.000Z",
      "completed_at": null,
      "recipients_total": 1,
      "recipients_signed": 0
    }
  ],
  "next_cursor": null
}

Examples

curl

curl https://tryjustdocs.com/api/v1/signing-requests \
  -H "Authorization: Bearer $JUSTDOCS_API_KEY"

Node.js

const response = await fetch("https://tryjustdocs.com/api/v1/signing-requests", {
  headers: {
    Authorization: `Bearer ${process.env.JUSTDOCS_API_KEY}`,
  },
});
if (!response.ok) throw new Error((await response.json()).message);
const result = await response.json();

Python

import os
import requests

response = requests.get(
    "https://tryjustdocs.com/api/v1/signing-requests",
    headers={"Authorization": f"Bearer {os.environ['JUSTDOCS_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
result = response.json()