Skip to main content
GET
/
v2
/
policies
List Policies
curl --request GET \
  --url https://api.dfns.io/v2/policies \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "Active",
      "activityKind": "Registry:Addresses:Modify",
      "rule": {
        "kind": "AlwaysTrigger",
        "configuration": {}
      },
      "action": {
        "kind": "RequestApproval",
        "approvalGroups": [
          {
            "quorum": 2,
            "approvers": {
              "userId": {
                "in": [
                  "<string>"
                ]
              }
            },
            "name": "<string>",
            "initiatorCanApprove": true
          }
        ],
        "autoRejectTimeout": 2
      },
      "dateCreated": "<string>",
      "dateUpdated": "<string>",
      "filters": {},
      "pendingChangeRequest": {
        "id": "<string>",
        "requester": {
          "userId": "<string>",
          "tokenId": "<string>",
          "appId": "<string>"
        },
        "kind": "Policy",
        "operationKind": "Update",
        "status": "Applied",
        "entityId": "<string>",
        "dateCreated": "2023-11-07T05:31:56Z",
        "body": {
          "id": "<string>",
          "name": "<string>",
          "status": "Active",
          "activityKind": "Registry:Addresses:Modify",
          "rule": {
            "kind": "AlwaysTrigger",
            "configuration": {}
          },
          "action": {
            "kind": "RequestApproval",
            "approvalGroups": [
              {
                "quorum": 2,
                "approvers": {
                  "userId": {
                    "in": [
                      "<string>"
                    ]
                  }
                },
                "name": "<string>",
                "initiatorCanApprove": true
              }
            ],
            "autoRejectTimeout": 2
          },
          "dateCreated": "<string>",
          "dateUpdated": "<string>",
          "filters": {}
        },
        "dateResolved": "2023-11-07T05:31:56Z",
        "approvalId": "<string>"
      }
    }
  ],
  "nextPageToken": "<string>"
}

​
Authentication

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

​
Required Permissions

Policies: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
string
Pattern: ^\d+$
​
paginationToken
string
Minimum string length: 1
​
status
enum<string>
Available options:
Active,
Archived

Response

200 - application/json

Success

​
items
(Registry:Addresses:Modify · object | Permissions:Assign · object | Permissions:Modify · object | Policies:Modify · object | Registry:ContractSchemas:Modify · object | Wallets:Sign · object | Wallets:IncomingTransaction · object)[]
required
​
nextPageToken
string
Last modified on February 26, 2026