Skip to main content
GET
/
keys
/
{keyId}
/
signatures
List Signatures
curl --request GET \
  --url https://api.dfns.io/keys/{keyId}/signatures \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "sig-4sfvl-f4iha-umighfi3hk4t54dr",
      "keyId": "key-01snl-t56gb-j8tsok0vn802p80i",
      "requester": {
        "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
        "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
      },
      "requestBody": {
        "hash": "<string>",
        "taprootMerkleRoot": "<string>",
        "externalId": "<string>"
      },
      "dateRequested": "2023-04-14T20:41:28.715Z",
      "reason": "<string>",
      "signature": {
        "r": "<string>",
        "s": "<string>",
        "recid": 123,
        "encoded": "<string>"
      },
      "signatures": [
        {
          "r": "<string>",
          "s": "<string>",
          "recid": 123,
          "encoded": "<string>"
        }
      ],
      "signedData": "<string>",
      "txHash": "<string>",
      "fee": "<string>",
      "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
      "datePolicyResolved": "2023-04-14T20:41:28.715Z",
      "dateSigned": "2023-04-14T20:41:28.715Z",
      "dateConfirmed": "2023-04-14T20:41:28.715Z",
      "externalId": "<string>",
      "details": {}
    }
  ],
  "keyId": "key-01snl-t56gb-j8tsok0vn802p80i",
  "nextPageToken": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dfns.co/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Keys:Signatures:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
keyId
string
required

The key to list signatures for.

Required string length: 1 - 64

Query Parameters

​
limit
integer
default:50

Maximum number of items to return.

Required range: 1 <= x <= 500
​
paginationToken
string

Opaque token used to retrieve the next page. Returned as nextPageToken from the previous request.

Minimum string length: 1

Response

200 - application/json

Success

​
items
object[]
required

Current page items.

​
keyId
string
required

The key these signatures belong to.

Required string length: 1 - 64
Pattern: ^key-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"key-01snl-t56gb-j8tsok0vn802p80i"

​
nextPageToken
string

token to use as paginationToken to request the next page.

Last modified on May 29, 2026