List Keys

Retrieve all keys registered for your organization.

GET /keys

List Keys

cURL

curl --request GET \
  --url https://api.dfns.io/keys \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "key-01snl-t56gb-j8tsok0vn802p80i",
      "publicKey": "<string>",
      "custodial": true,
      "dateCreated": "2023-04-14T20:41:28.715Z",
      "masterKey": true,
      "derivedFrom": {
        "keyId": "key-01snl-t56gb-j8tsok0vn802p80i",
        "path": "<string>"
      },
      "name": "<string>",
      "imported": true,
      "exported": true,
      "dateExported": "2023-04-14T20:41:28.715Z",
      "dateDeleted": "2023-04-14T20:41:28.715Z"
    }
  ],
  "nextPageToken": "<string>"
}

Authentication

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

Required Permissions

Keys:Read: Always required.

Authorizations

Authorization · string · header · required

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

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

owner · string

Filter by owner id or username.

Minimum string length: 1

Response

200 - application/json

Success

items · object[] · required

Current page items.

Show child attributes

nextPageToken · string

token to use as paginationToken to request the next page.