---
title: "Retrieve a settlement rule"
method: GET
path: "/v2/virtual-accounts/settlement-rules/{ruleId}"
tags: ["Settlement Rules"]
---

# Retrieve a settlement rule

`GET /v2/virtual-accounts/settlement-rules/{ruleId}`

Get an existing settlement rule detail.

## Path parameters

- `ruleId` string, required

## Response `200`

Success

- SettlementRuleResponse
  - `id` string, required — Unique identifier for the settlement rule
  - `chain` 'BASE' | 'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'TRON', 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

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `500` — Internal Server Error

---

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