---
title: "Account status updated"
method: POST
path: "account.status_updated"
tags: ["Webhooks"]
---

# Account status updated

`POST account.status_updated` (webhook)

Sent when an account changes status (e.g. `PROVISIONING` → `ACTIVE`, `ACTIVE` → `SUSPENDED`, `CLOSED`, `REJECTED`). No notification is sent when the status does not change. Set the destination URL using `status_callback_url` when creating the account or with [Update Account](ref:v1_4_update_account__). The body is identical to the [Get Account Details](ref:v1_2_get_account_) response.

## Payload

- PublicAccountSchema
  - `id` integer, required: Account ID
  - `created_at` string, date-time: Creation date of the account
  - `updated_at` string, date-time: Last update date of the account
  - `status` 'PROVISIONING' | 'ACTIVE' | 'SUSPENDED' | 'CLOSED' | 'REJECTED'
  - `status_reason` string: Why the account is in its current status, when known (e.g. the reason a KYC/KYB verification was rejected). Usually set for SUSPENDED, REJECTED or CLOSED accounts; null otherwise.
  - `label` string: Account label
  - `idempotency_key` string: Idempotency key for the account creation, it can also be used as an external identifier
  - `bank` string, required: Name of the bank where the account is held
  - `company_id` integer: Company ID associated with the account
  - `currency` 'BRL' | 'BRLA' | 'MXN' | 'ARS' | 'COP' | 'CLP' | 'BOB' | 'PYG' | 'SGD' | 'PEN' | 'EUR' | 'GBP' | 'USD' | 'USDT' | 'USDC' | 'UYU' | 'USDC_POL' | 'USDT_POL' | 'EURC_BASE' | 'USDC_BASE' | 'USDT_BASE' | 'USDC_ETH' | 'USDT_ETH' | 'EURC_ETH' | 'USDC_TEMPO' | 'USDT_TEMPO' | 'EURC_TEMPO' | 'OUSD_TEMPO' | 'USDC_MONAD' | 'USDT_MONAD' | 'OUSD_BASE' | 'OUSD_ETH' | 'OUSD_SOL' | 'BRLA_ETH' | 'BRLA_POL' | 'BRLA_BASE' | 'TGBP_ETH' | 'TGBP_POL' | 'TGBP_BASE' | 'USDC_SOL' | 'USDT_SOL' | 'USDT_TRX' | 'MXNB_BASE', required
  - `country` 'BR' | 'AR' | 'CO' | 'CL' | 'BO' | 'PY' | 'SG' | 'PE' | 'MX' | 'UY' | 'US' | 'EU' | 'XX' | 'GB', required
  - `account_number` string: Account number
  - `enabled` boolean: Indicates if the account is enabled or not. Disabled accounts will not be able to perform any operations until they are enabled again.
  - `account_type` string: Type of the account
  - `document_number` string: Document number of the account holder
  - `document_type` string: Document type of the account holder
  - `funding_instructions` union: Funding instructions for the account, if applicable
    - FiatFundingInstructions
      - `type` 'fiat'
      - `account_number` string: Account number to fund
      - `bank_name` string: Bank name associated with the account number
      - `bank_code` string: Bank identifier (routing number in USA, sort code in UK, ISPB in BR, etc.)
      - `br_code` string: BR code for Brazil (BRL) funding instructions
      - `breb_key` string: BREB key for Colombia (COP) funding instructions
      - `ted_brl` TedBRLFundingRail
        - `bank_code` string, required
        - `branch_number` string, required
        - `account_number` string, required
        - `account_type` string, required
        - `beneficiary_name` string
        - `beneficiary_document` string
      - `pix_key_brl` PixKeyBrlFundingRail
        - `pix_key` string, required
      - `br_code_brl` BrCodeBrlFundingRail
        - `br_code` string, required
      - `pen` PenFundingRail
        - `cci` string, required
        - `qr` PenQrFundingRail
          - `qr_code` string, required
          - `expiration_date` string, required
      - `fps_gbp` FPSGBP
        - `account_number` string, required
        - `sort_code` string, required
        - `account_holder_name` string, required
      - `iban` string: European IBAN
      - `bic` string: Swift/BIC code
    - CryptoFundingInstructions
      - `type` 'crypto'
      - `crypto_address` string, required: Crypto address to funds
      - `crypto_network` string, required: Crypto network to fund
  - `balance_details` BalanceSchema
    - `total` number: The overall balance, including both available and held funds.
    - `available` number: The portion of the balance that is currently available for transactions, excluding amounts held for pending operations.
    - `last_update` string, date-time: The timestamp of the last balance update, reflecting the most recent change.
  - `is_virtual_account` boolean: Indicates if the account is a virtual account
  - `webhook_url` string: Webhook URL for movement notifications
  - `status_callback_url` string: Callback URL for account-level events
  - `products` AccountProductsEnum[]: List of products associated with the account
  - `owner_id` string: UUID of the Account Owner linked to this account

## Acknowledgement `200`

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

---

[API](https://skmtc.dev/infiniaweb/apis/accounts.md) - [All operations](https://skmtc.dev/infiniaweb/apis/accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/accounts/revisions/2faae77050e4?raw)