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",
      "dateCreated": "<string>",
      "dateUpdated": "<string>",
      "activityKind": "Alias:Modify",
      "rule": {
        "kind": "AlwaysTrigger",
        "configuration": {}
      },
      "action": {
        "kind": "RequestApproval",
        "approvalGroups": [
          {
            "name": "<string>",
            "quorum": 2,
            "approvers": {
              "userId": {
                "in": [
                  "<any>"
                ]
              }
            },
            "initiatorCanApprove": true
          }
        ],
        "autoRejectTimeout": 2
      },
      "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",
        "dateResolved": "2023-11-07T05:31:56Z",
        "approvalId": "<string>",
        "body": {
          "id": "<string>",
          "name": "<string>",
          "status": "Active",
          "dateCreated": "<string>",
          "dateUpdated": "<string>",
          "activityKind": "Alias:Modify",
          "rule": {
            "kind": "AlwaysTrigger",
            "configuration": {}
          },
          "action": {
            "kind": "RequestApproval",
            "approvalGroups": [
              {
                "name": "<string>",
                "quorum": 2,
                "approvers": {},
                "initiatorCanApprove": true
              }
            ],
            "autoRejectTimeout": 2
          },
          "filters": {}
        }
      }
    }
  ],
  "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
paginationToken
string
Minimum length: 1
status
enum<string>
Available options:
Active,
Archived

Response

200 - application/json

Success

items
(Alias:Modify · object | Permissions:Assign · object | Permissions:Modify · object | Policies:Modify · object | Wallets:Sign · object | Wallets:IncomingTransaction · object)[]
required
  • Alias:Modify
  • Permissions:Assign
  • Permissions:Modify
  • Policies:Modify
  • Wallets:Sign
  • Wallets:IncomingTransaction
nextPageToken
string
I