> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craftkit.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List signature requests

> GET /v1/signatures — list a project's signature requests, newest first, cursor-paginated.

<Info>**GET** `https://api.craftkit.dev/v1/signatures`</Info>

Returns the authenticated project's signature requests ordered by `createdAt` descending, paginated
with a keyset cursor.

## Authorization

<ParamField header="Authorization" type="string" required>
  `Bearer ck_live_…` — a project API key.
</ParamField>

## Query parameters

<ParamField query="limit" type="number" default="50">
  Page size, 1–100.
</ParamField>

<ParamField query="renderId" type="string">
  Filter to signature requests for a single render (UUID).
</ParamField>

<ParamField query="cursor" type="string">
  Keyset cursor (ISO-8601). Returns rows created strictly before this timestamp. Pass the previous
  page's `nextCursor`.
</ParamField>

## Response

<ResponseField name="signatures" type="object[]">
  Signature requests (same shape as the [create](/api-reference/create-signature) response).
</ResponseField>

<ResponseField name="nextCursor" type="string | null">
  Pass as `cursor` for the next page; `null` when there are no more rows.
</ResponseField>

<ResponseField name="hasMore" type="boolean">
  `true` when a full page was returned and more rows may exist.
</ResponseField>

## Errors

| Status | code              | Meaning                                       |
| ------ | ----------------- | --------------------------------------------- |
| 400    | `invalid_request` | Invalid query parameters (`issues` included). |
| 401    | `unauthorized`    | Missing/invalid/revoked key.                  |

```bash cURL theme={null}
curl "https://api.craftkit.dev/v1/signatures?limit=20" \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json 200 theme={null}
{
  "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
}
```