> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.finrock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Spending Rules

> Retrieve the spending rules in your Finrock sub-account: who can send, where, how much, and whether approval is needed.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `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.

```bash cURL theme={null}
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.

**rule\_guid** `string`

Unique ID of the rule. Use it with [Delete Spending Rule](https://apidocs.finrock.io/api-reference/spending-rules/delete-spending-rule.md).

**rule\_title** `string`

The rule's name.

**initiated\_by** `string`

Who the rule applies to. See [initiated\_by values](https://apidocs.finrock.io/reference/spending-rule-values.md#initiated_by).

**destination\_type** `string`

Where funds are going. See [destination\_type values](https://apidocs.finrock.io/reference/transaction-types.md#destination_type).

**destination\_id** `string`

For `External` destinations, the kind of address. See [destination\_id values](https://apidocs.finrock.io/reference/spending-rule-values.md#destination_id).

**destination\_title** `string | null`

For `WhitelistedAddress` rules, the name of the [whitelist](https://apidocs.finrock.io/guides/whitelist-addresses.md). `null` for ad-hoc addresses.

**external\_address** `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.

**amount** `number`

The maximum amount the rule allows in the time period.

**rule\_type** `string`

The period the amount applies to. See [rule\_type values](https://apidocs.finrock.io/reference/spending-rule-values.md#rule_type).

**time\_period\_frequency** `integer`

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

**sr\_action** `string`

What happens to a matching transaction. See [sr\_action values](https://apidocs.finrock.io/reference/spending-rule-values.md#sr_action).

**minimum\_approvals** `integer`

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

**created\_on** `string`

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

**status** `string`

The rule's status. See [status values](https://apidocs.finrock.io/reference/spending-rule-values.md#status).

```json 200 expandable theme={null}
[
  {
    "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"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.