---
title: "List all settlement rules"
method: GET
path: "/v2/virtual-accounts/settlement-rules"
tags: ["Settlement Rules"]
---

# List all settlement rules

`GET /v2/virtual-accounts/settlement-rules`

List all settlement rules available for virtual accounts.

## Query parameters

- `limit` string
- `createdBefore` string
- `createdAfter` string
- `chain` 'BASE' | 'POLYGON' | 'ETHEREUM' | 'SOLANA'

## Response `200`

Success

- SettlementRuleListResponse
  - `count` integer, required — Total number of settlement rules
  - `rules` SettlementRuleResponse[], required — Array of settlement rules
    - `id` string, required — Unique identifier for the settlement rule
    - `chain` 'BASE' | 'POLYGON' | 'ETHEREUM' | 'SOLANA', required — Blockchain network for the settlement rule
    - `includeHIFIFee` boolean, required — Whether to include HiFi's fee in addition to custom rules, please contact HiFi support if you want to include HiFi's fee
    - `rules` SettlementRule[], required — Array of settlement rules
      - `type` 'PERCENTAGE' | 'FIXED', required — Type of fee calculation
      - `calculationModel` 'FIXED' | 'TIERED', required — Model for calculating the fee
      - `value` number, nullable — Fixed fee value (omit for tiered calculation model)
      - `tiers` SettlementRuleTier[], nullable — Tiered fee structure (omit for fixed calculation model)
        - `min` string, required — Minimum value for this tier (empty string is required for first tier)
        - `max` string, required — Maximum value for this tier (empty string is required for last tier)
        - `value` number, required — Fee value for this tier
      - `walletAddress` string, required — Wallet address to receive the fee
  - `nextCursor` string, nullable — Cursor for pagination to the next page of results

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifibridge/apis/hifi-api.md) · [All operations](https://skmtc.net/hifibridge/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifibridge/hifi-api/versions/74d9e530fbea/schema)