Skip to main content
GET https://api.craftkit.dev/v1/signatures
Returns the authenticated project’s signature requests ordered by createdAt descending, paginated with a keyset cursor.

​
Authorization

​
Authorization
string
required
Bearer ck_live_… — a project API key.

​
Query parameters

​
limit
number
default:"50"
Page size, 1–100.
​
renderId
string
Filter to signature requests for a single render (UUID).
​
cursor
string
Keyset cursor (ISO-8601). Returns rows created strictly before this timestamp. Pass the previous page’s nextCursor.

​
Response

​
signatures
object[]
Signature requests (same shape as the create response).
​
nextCursor
string | null
Pass as cursor for the next page; null when there are no more rows.
​
hasMore
boolean
true when a full page was returned and more rows may exist.

​
Errors

StatuscodeMeaning
400invalid_requestInvalid query parameters (issues included).
401unauthorizedMissing/invalid/revoked key.
cURL
curl "https://api.craftkit.dev/v1/signatures?limit=20" \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
200
{
  "signatures": [
    {
      "id": "0193c2c3-2222-7aaa-8bbb-000000000002",
      "renderId": "0193c2c3-1111-7aaa-8bbb-000000000001",
      "name": "Charter handover — BK-12345",
      "status": "completed",
      "recipients": [],
      "expirationHours": 168,
      "signedDownloadUrl": "https://api.craftkit.dev/v1/signatures/0193c2c3-2222-7aaa-8bbb-000000000002/download",
      "certificateUrl": "https://api.craftkit.dev/v1/signatures/0193c2c3-2222-7aaa-8bbb-000000000002/certificate",
      "errorMessage": null,
      "createdAt": "2026-06-05T10:00:00.000Z",
      "completedAt": "2026-06-05T11:42:08.000Z"
    }
  ],
  "nextCursor": "2026-06-05T10:00:00.000Z",
  "hasMore": false
}