---
title: "Apply settlement rule to virtual account"
method: POST
path: "/v2/users/{userId}/virtual-accounts/{accountId}/settlement-rules/{ruleId}"
tags: ["Settlement Rules"]
---

# Apply settlement rule to virtual account

`POST /v2/users/{userId}/virtual-accounts/{accountId}/settlement-rules/{ruleId}`

## Request

- Base URL: `https://production.hifibridge.com`
- URL: `https://production.hifibridge.com/v2/users/{userId}/virtual-accounts/{accountId}/settlement-rules/{ruleId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hifibridge/apis/hifi-api/docs/v2/users/:userId/virtual-accounts/:accountId/settlement-rules/:ruleId/post.ts> (a function with typed inputs; its response is checked against the schema)

Apply a settlement rule to a specific virtual account. This will enable the fee structure defined in the rule for transactions on that account.

## Path parameters

- `userId` string, required
- `accountId` string, required
- `ruleId` string, required

## Response `200`

Success

- ApplySettlementRuleResponse
  - `message` string, required: Success message

## Other responses

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

---

[API](https://skmtc.dev/hifibridge/apis/hifi-api.md) - [All operations](https://skmtc.dev/hifibridge/apis/hifi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hifibridge/apis/hifi-api/revisions/74d9e530fbea?raw)
