List Signature Requests

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

List signature requests of a key.

• Request headers required. See Request Headers for more information.

• Authentication required. See Authentication Headers for more information.

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.
nextPageToken	Opaque token used to retrieve the next page of items by setting as paginationToken in the query parameter.	String (optional)

200 Success

{
  "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",
        "appId": "ap-24vva-92s32-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=="
}