POST /account/web/update_account_status

Activate or deactivate an account via the Dashboard API. Only active and inactive states are user-controllable; blocked accounts require support.

Use this endpoint to activate or deactivate an account you own. You can toggle an account between active and inactive states to control whether it can send or receive funds. This is useful for temporarily suspending activity on a branch account or re-enabling one after a review.

You can only switch accounts between active and inactive. Accounts in a blocked or closed state cannot be modified through this endpoint — contact [e-mail] to resolve those cases.

Endpoint

POST /api/v1/account/web/update_account_status

Authentication

Include your JWT access token in the Authorization header.

Authorization: Bearer <access_token>

Obtain a token via POST /auth/web/login.

Request body

account_number · string · required

The 10-digit account number of the account you want to update.

status · string · required

The new status to assign to the account. Accepted values: active, inactive.

Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/account/web/update_account_status \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "account_number": "7801234567",
    "status": "inactive"
  }'

Response

A successful request returns the updated account object.

status · boolean

true when the request succeeds.

response_code · string

"00" on success.

data · object

The updated account object with the new status reflected.

Show data fields

account_number · string

The 10-digit account number.

account_name · string

The human-readable account label.

account_type · string

Type of account: normal, virtual, current, or savings.

status · string

The new account status — either active or inactive.

balance · string

Current account balance as a decimal string.

{
  "status": true,
  "response_code": "00",
  "message": "Account status updated successfully",
  "data": {
    "account_number": "7801234567",
    "account_name": "Lagos Branch Sales",
    "account_type": "current",
    "status": "inactive",
    "balance": "250000.000000000",
    "last_balance_update": "2026-02-25T12:00:00Z"
  }
}

Error codes

Response code	Meaning
41	Customer not found — your session credentials are invalid.
44	Account not found — no account matches the provided account number.
45	Invalid status transition — you cannot set this status on a blocked or closed account.