Policy Approvals - Dfns documentation

{
  "id": "<string>",
  "initiatorId": "<string>",
  "activity": {
    "swapRequest": {
      "id": "swap-6a3ku-bn8d7-8u5rs1oukojms7k8",
      "quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
      "reference": null,
      "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
      "targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
      "status": "PendingPolicyApproval",
      "provider": "UniswapClassic",
      "quotedSourceAsset": {
        "kind": "Native",
        "amount": "10000000000",
        "metadata": {
          "network": "EthereumSepolia",
          "name": "Ethereum",
          "symbol": "SepoliaETH",
          "decimals": 18,
          "tid": "native:eth"
        }
      },
      "quotedTargetAsset": {
        "kind": "Erc20",
        "contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
        "amount": "6467571553831928182",
        "metadata": {
          "network": "EthereumSepolia",
          "name": "Test",
          "symbol": "Test",
          "decimals": 18,
          "tid": "erc20:0xda0be7efd234295395d4204d0df4358339b57b27"
        }
      },
      "slippageBps": 100,
      "dateCreated": "2025-09-11T10:57:55.758Z",
      "requestBody": {
        "quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
        "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
        "targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
        "provider": "UniswapClassic",
        "slippageBps": 100,
        "sourceAsset": {
          "kind": "Native",
          "amount": "10000000000"
        },
        "targetAsset": {
          "kind": "Erc20",
          "contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
          "amount": "653003161"
        }
      },
      "requester": {
        "userId": "us-48r5q-eshfg-9pmr2lo6bmpr4i4i",
        "tokenId": "to-4etah-smoal-9n3rmhul4dpaueg5"
      }
    }
  },
  "dateUpdated": "<string>",
  "policyEvaluations": [
    {
      "policyId": "<string>",
      "triggered": true,
      "reason": "<string>",
      "context": "<unknown>"
    }
  ],
  "decisions": [
    {
      "userId": "<string>",
      "date": "<string>",
      "reason": "<string>"
    }
  ],
  "expirationDate": "<string>",
  "dateCreated": "<string>",
  "dateResolved": "<string>"
}

When a policy is triggered and the action defined is RequestApproval, an Approval object is created containing:

details about the activity that triggered this approval flow
details on the different policy evaluations that happened for that activity and their result
details about the decisions given by each approvers

When a new Approval object is created and an approval process is required, a webhook event is emitted (event kind “policy.approval.pending”). You can subscribe to it to react to this event, eg. send notifications to the users that need to give their approval. The Approval object can be queried using the approvalId returned from the endpoint that triggered the approval process, using the Get Approval / List Approvals endpoints. Users can then call the Create Approval Decision endpoint to either approve / reject this activity. Of course this can also be done via the Dfns dashboard. A user can only give his approval / rejection if he is defined inside one of the approval groups defined on the policies that triggered. A given user can only approve or reject once. If multiple approval groups exist, a decision from a single user will count as a decision for any of the groups this user belongs to. A rejection from any user of any groups immediately rejects an activity. The initiator is not allowed to approve their activity, but can deny it if they need to cancel it. Here’s an Approval object example

{
  "id":"ap-...",
  "initiatorId":"us-...",
  "status":"Pending",
  "expirationDate":"2023-12-22T21:16:16.659Z",
  "dateCreated":"2023-12-22T20:56:16.662Z",
  "dateUpdated":"2023-12-22T20:56:16.662Z",
  "activity":{
    "kind": "Wallets:Sign",
    "transferRequest": { // the transfer request object from transfer endpoint
      "id": "xfr-...",
      ...
    },
  },
  "evaluatedPolicies":[
    {
      "policyId":"plc-...",
      "triggerStatus":"Triggered",
      "reason":"Number of transactions (2) is above limit (2)."
    },
    {
      "policyId":"plc-...",
      "triggerStatus":"Triggered",
      "reason":"Cumulative transfer amount (USD 20) is above limit (USD 2)."
    }
  ],
  "decisions":[
    {
      "userId":"us-...",
      "dateActioned":"2023-12-22T20:56:16.662Z",
      "value":"Approved"
    }
  ],
}

Policy Approval object

string

required

initiatorId

string

required

activity

Wallets:Sign · object

required

A "`Wallets:Sign`" activity represents any activity which involves signing with a wallet. Currently, in our API, these can be:

a Transfer Request (created using the endpoint Transfer Asset from Wallet)
a Transaction Request (created using the endpoint Broadcast Transaction from Wallet)
a Signature Request (created using the endpoint Generate Signature from Wallet)

Show child attributes

status

enum<string>

required

Available options:

Pending,

Approved,

Denied,

Expired

dateUpdated

string

required

policyEvaluations

object[]

required

Show child attributes

decisions

object[]

required

Show child attributes

expirationDate

string

dateCreated

string

dateResolved

string

Last modified on May 15, 2026

Policy activity resolved

Create Approval Decision

⌘I

Documentation Index

​Policy Approval object

Policy Approval object