---
title: "Decide bank account change request"
method: POST
path: "/money/accounts/bank_account_changes/{id}/approve"
tags: ["money", "accounts"]
---

# Decide bank account change request

`POST /money/accounts/bank_account_changes/{id}/approve`

## Request

- Base URL: `https://api.stablesea.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stablesea.com/money/accounts/bank_account_changes/{id}/approve`
- Auth: none declared

Records the member's vote. The requester can never approve their own request. A matching replay returns the current request; a conflicting decision returns 409. The account is added by the background worker once the rule is met.

## Path parameters

- `id` string, required

## Request body

- MoneyAccountsBankAccountChangeDecisionInput
  - `note` string

## Response `200`

OK

- MoneyAccountsBankAccountChangeView
  - `account_id` string: The account the change adds. It exists only once the change is applied.
  - `account_number_masked` string: The account number, or the CLABE, masked to its last four digits.
  - `account_type` 'checking' | 'saving'
  - `approval_allowed` boolean
  - `approval_progress` MoneyAccountsDestinationApprovalProgress: How far a pending request has come toward its approval rule, counted the way the request is decided. Present only while the request is pending; the quorum is the request's required_approvals.
    - `approvals_received` integer, required: Approvals recorded toward required_approvals, from eligible members other than the requester and the named member.
    - `named_approval_pending` boolean, required: True while the member the business's rule also requires has not approved.
    - `selected_approval_pending` boolean, required: True while the teammate the requester's own approval setting names has not approved. False when that teammate is also the rule's named member, whose sign-off named_approval_pending reports.
  - `bank_name` string
  - `beneficiary_type` 'self' | 'third_party', nullable
  - `cancellation_allowed` boolean
  - `created_ts` string, date-time
  - `expires_ts` string, date-time
  - `history` MoneyAccountsBankAccountChangeEvent[], nullable: When the request was made, then its votes and how it ended, oldest first. A request with more events keeps the first and the newest 49.
    - `actor_id` string, nullable
    - `actor_name` string
    - `note` string, nullable
    - `recorded_ts` string, date-time
    - `state` 'pending' | 'approved' | 'applied' | 'denied' | 'cancelled' | 'expired' | 'policy_changed'
  - `holder_name` string: The account holder. Masked to its first character unless the viewer holds bank_account_add or bank_account_remove, or the request asks the viewer to decide it.
  - `id` string
  - `kind` 'add'
  - `named_approver_id` string, nullable: The member the business's bank account rule also requires, when it names one.
  - `named_approver_name` string
  - `requester_id` string
  - `requester_name` string
  - `required_approvals` integer: Approvals the business's bank account rule requires from eligible members other than the requester and the named member.
  - `routing_number` string
  - `state` 'pending' | 'approved' | 'applied' | 'denied' | 'cancelled' | 'expired' | 'policy_changed'
  - `type` 'us_bank_account' | 'mx_bank_account'

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `503`: Service Unavailable
- `default`: Error response.

## Changes

- **2026-11-19** `aa2e3c3161d7`: 1 info
  - added the optional property `approval_progress` to the response with the `200` status
- **2026-11-19** `328f3a8ffd8d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stablesea/apis/stable-sea-backend/changes/money/accounts/bank_account_changes/:id/approve/post.md)

---

[API](https://skmtc.dev/stablesea/apis/stable-sea-backend.md) - [All operations](https://skmtc.dev/stablesea/apis/stable-sea-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/stablesea/apis/stable-sea-backend/revisions/aa2e3c3161d7?raw)
