List Spending Rules

curl --request GET \
     --url https://api.finrock.io/dac/v1/spending-rule \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

[
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "WhitelistedAddress",
    "destination_title": "Move to Prod",
    "external_address": "f59efb58-1891-4b21-9514-5d37a36cb415",
    "amount": 500.00000000,
    "minimum_approvals": 0,
    "rule_type": "PerTransaction",
    "time_period_frequency": 0,
    "rule_guid": "4581ea4c-e6bb-4c85-bdbb-bf0bd2fd98eb",
    "rule_title": "Move to Prod",
    "sr_action": "Allow",
    "created_on": "2023-03-09T11:04:58Z",
    "status": "Active"
  },
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "AdhocAddress",
    "destination_title": null,
    "external_address": "Any",
    "amount": 500.00000000,
    "minimum_approvals": 2,
    "rule_type": "Hourly",
    "time_period_frequency": 24,
    "rule_guid": "f2f97ab8-f8ed-46eb-ae48-d93533893baf",
    "rule_title": "Spending Rule 1",
    "sr_action": "NeedsApproval",
    "created_on": "2026-10-30T11:01:15Z",
    "status": "UnApproved"
  }
]

GET

dac

spending-rule

curl --request GET \
     --url https://api.finrock.io/dac/v1/spending-rule \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

[
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "WhitelistedAddress",
    "destination_title": "Move to Prod",
    "external_address": "f59efb58-1891-4b21-9514-5d37a36cb415",
    "amount": 500.00000000,
    "minimum_approvals": 0,
    "rule_type": "PerTransaction",
    "time_period_frequency": 0,
    "rule_guid": "4581ea4c-e6bb-4c85-bdbb-bf0bd2fd98eb",
    "rule_title": "Move to Prod",
    "sr_action": "Allow",
    "created_on": "2023-03-09T11:04:58Z",
    "status": "Active"
  },
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "AdhocAddress",
    "destination_title": null,
    "external_address": "Any",
    "amount": 500.00000000,
    "minimum_approvals": 2,
    "rule_type": "Hourly",
    "time_period_frequency": 24,
    "rule_guid": "f2f97ab8-f8ed-46eb-ae48-d93533893baf",
    "rule_title": "Spending Rule 1",
    "sr_action": "NeedsApproval",
    "created_on": "2026-10-30T11:01:15Z",
    "status": "UnApproved"
  }
]

MCP scope: dac.read Spending rules decide which outgoing transactions are allowed, which need approval, and how much can be sent. Use this endpoint to list the rules in your sub-account and see each one’s status.

curl --request GET \
     --url https://api.finrock.io/dac/v1/spending-rule \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Response

A successful request returns HTTP 200 with an array of spending rules.

string

Unique ID of the rule. Use it with Delete Spending Rule.

string

The rule’s name.

string

Who the rule applies to. See initiated_by values.

string

Where funds are going. See destination_type values.

string

For External destinations, the kind of address. See destination_id values.

string | null

For WhitelistedAddress rules, the name of the whitelist. null for ad-hoc addresses.

string

For WhitelistedAddress rules, the ID of the whitelist. For AdhocAddress rules, the specific address outside Finrock that the rule applies to, or Any if it covers every address. For SubAccount destinations, the ID of the sub-account.

number

The maximum amount the rule allows in the time period.

string

The period the amount applies to. See rule_type values.

integer

The length of the period, in units of rule_type. For example, Hourly with 24 means any 24-hour window. 0 for PerTransaction.

string

What happens to a matching transaction. See sr_action values.

integer

How many approvals a matching transaction needs when sr_action is NeedsApproval.

string

When the rule was created, as an ISO 8601 timestamp in UTC.

string

The rule’s status. See status values.

[
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "WhitelistedAddress",
    "destination_title": "Move to Prod",
    "external_address": "f59efb58-1891-4b21-9514-5d37a36cb415",
    "amount": 500.00000000,
    "minimum_approvals": 0,
    "rule_type": "PerTransaction",
    "time_period_frequency": 0,
    "rule_guid": "4581ea4c-e6bb-4c85-bdbb-bf0bd2fd98eb",
    "rule_title": "Move to Prod",
    "sr_action": "Allow",
    "created_on": "2023-03-09T11:04:58Z",
    "status": "Active"
  },
  {
    "initiated_by": "Anyone",
    "destination_type": "External",
    "destination_id": "AdhocAddress",
    "destination_title": null,
    "external_address": "Any",
    "amount": 500.00000000,
    "minimum_approvals": 2,
    "rule_type": "Hourly",
    "time_period_frequency": 24,
    "rule_guid": "f2f97ab8-f8ed-46eb-ae48-d93533893baf",
    "rule_title": "Spending Rule 1",
    "sr_action": "NeedsApproval",
    "created_on": "2026-10-30T11:01:15Z",
    "status": "UnApproved"
  }
]