# List Signature Requests

`GET /keys/{keyId}/signatures?paginationToken={token}`

List signature requests of a key.

{% hint style="info" %}

* Request headers required. See [Request Headers](https://docs-legacy.dfns.co/d/advanced-topics/authentication/request-headers) for more information.
* Authentication required. See [Authentication Headers](https://docs-legacy.dfns.co/d/advanced-topics/authentication/request-headers#authentication-headers) for more information.
  {% endhint %}

## Required Permissions

| Name                   | Conditions      |
| ---------------------- | --------------- |
| `Keys:Signatures:Read` | Always Required |

## Parameters

### Path parameters

| Path parameter | Description                   |
| -------------- | ----------------------------- |
| `keyId`        | Unique identifier of the key. |

### Query parameters

| Query parameter   | Description                                                                                         | Type - Optional      |
| ----------------- | --------------------------------------------------------------------------------------------------- | -------------------- |
| `limit`           | Maximum number of items to return. Default to 100.                                                  | Integer *(optional)* |
| `paginationToken` | Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. | String *(optional)*  |

## Response Body

| Field           | Description                                                                                                  | Type - Optional                                                                                             |
| --------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| `keyId`         | ID of the key.                                                                                               | String                                                                                                      |
| `items`         | List of signature requests.                                                                                  | See [Generate Signature Response](https://docs-legacy.dfns.co/d/api-docs/generate-signature#response-body). |
| `nextPageToken` | Opaque token used to retrieve the next page of items by setting as `paginationToken` in the query parameter. | String *(optional)*                                                                                         |

### 200 Success

```json
{
  "keyId": "key-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
  "items": [
    {
      "id": "sig-2ouaj-f4nq6-xxxxxxxxxxxxxxxx",
      "keyId": "key-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "requester": {
        "userId": "us-3v1ag-v6b36-xxxxxxxxxxxxxxxx",
        "tokenId": "to-7mkkj-c831n-xxxxxxxxxxxxxxxx",
      },
      "requestBody": {
        "kind": "Hash",
        "hash": "0x031edd7d41651593c5fe5c006fa5752b37fddff7bc4e843aa6af0c950f4b9406"
      },
      "status": "Signed",
      "signature": {
        "r": "0x05e365d4304eaa78516eb309bff91f8c12e5445a431e3f2428239678d0150c6c",
        "s": "0x47e0765c439fb42d57767910865d240964b7b09f2b2f74d8f14a63da7ce5a1fe",
        "recid": 0
      },
      "dateRequested": "2023-05-15T20:21:11.576Z",
      "dateSigned": "2024-01-10T19:07:40.533Z"
    },
    ...
  ],
  "nextPageToken": "WszQXoENUIYyoBQjJm4DE6QhCk2sB7WAh9kykUMaTQcD25SToKbuXkgf3td8ZYb2LrtopPLo35u407gwwA1Sug=="
}
```