---
updatedAt: 2026-06-08T00:54:03.000Z
agentTools:
  projectIndex: https://docs.infiniaweb.com/llms.txt
---

# Account status updated

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.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Accounts",
    "description": "Manage your virtual accounts and movements",
    "version": "0.1.0"
  },
  "servers": [
    {
      "url": "https://app2test.infiniaweb.com/infinia_api/v1/accounts",
      "description": "Sandbox"
    }
  ],
  "components": {
    "schemas": {
      "AccountProductsEnum": {
        "type": "string",
        "enum": [
          "PAYOUTS",
          "PAYINS",
          "INTERNAL_TRANSFER"
        ],
        "title": "AccountProductsEnum"
      },
      "AccountStatus": {
        "type": "string",
        "enum": [
          "PROVISIONING",
          "ACTIVE",
          "SUSPENDED",
          "CLOSED",
          "REJECTED"
        ],
        "title": "AccountStatus"
      },
      "BalanceSchema": {
        "properties": {
          "total": {
            "title": "Total",
            "description": "The overall balance, including both available and held funds.",
            "type": "number"
          },
          "available": {
            "title": "Available",
            "description": "The portion of the balance that is currently available for transactions, excluding amounts held for pending operations.",
            "type": "number"
          },
          "last_update": {
            "title": "Last Update",
            "description": "The timestamp of the last balance update, reflecting the most recent change.",
            "type": "string",
            "format": "date-time"
          }
        },
        "type": "object",
        "title": "BalanceSchema"
      },
      "BrCodeBrlFundingRail": {
        "properties": {
          "br_code": {
            "type": "string",
            "title": "Br Code"
          }
        },
        "type": "object",
        "required": [
          "br_code"
        ],
        "title": "BrCodeBrlFundingRail"
      },
      "Country": {
        "type": "string",
        "enum": [
          "BR",
          "AR",
          "CO",
          "CL",
          "BO",
          "PY",
          "SG",
          "PE",
          "MX",
          "UY",
          "US",
          "EU",
          "XX",
          "GB"
        ],
        "title": "Country"
      },
      "CryptoFundingInstructions": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type",
            "default": "crypto",
            "enum": [
              "crypto"
            ]
          },
          "crypto_address": {
            "title": "Crypto Address",
            "description": "Crypto address to funds",
            "type": "string"
          },
          "crypto_network": {
            "title": "Crypto Network",
            "description": "Crypto network to fund",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "crypto_address",
          "crypto_network"
        ],
        "title": "Crypto Funding"
      },
      "Currency": {
        "type": "string",
        "enum": [
          "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"
        ],
        "title": "Currency"
      },
      "FPS_GBP": {
        "properties": {
          "account_number": {
            "type": "string",
            "title": "Account Number"
          },
          "sort_code": {
            "type": "string",
            "title": "Sort Code"
          },
          "account_holder_name": {
            "title": "Account Holder Name",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "account_number",
          "sort_code",
          "account_holder_name"
        ],
        "title": "FPS_GBP"
      },
      "FiatFundingInstructions": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type",
            "default": "fiat",
            "enum": [
              "fiat"
            ]
          },
          "account_number": {
            "title": "Account Number",
            "description": "Account number to fund",
            "type": "string"
          },
          "bank_name": {
            "title": "Bank Name",
            "description": "Bank name associated with the account number",
            "type": "string"
          },
          "bank_code": {
            "title": "Bank Code",
            "description": "Bank identifier (routing number in USA, sort code in UK, ISPB in BR, etc.)",
            "type": "string"
          },
          "br_code": {
            "title": "Br Code",
            "description": "BR code for Brazil (BRL) funding instructions",
            "type": "string"
          },
          "breb_key": {
            "title": "Breb Key",
            "description": "BREB key for Colombia (COP) funding instructions",
            "type": "string"
          },
          "ted_brl": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TedBRLFundingRail"
              }
            ],
            "description": "TED funding rail details for BRL accounts"
          },
          "pix_key_brl": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PixKeyBrlFundingRail"
              }
            ],
            "description": "PIX key funding rail details for BRL accounts"
          },
          "br_code_brl": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BrCodeBrlFundingRail"
              }
            ],
            "description": "BR code funding rail details for BRL accounts"
          },
          "pen": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PenFundingRail"
              }
            ],
            "description": "Funding rail for Peru (PEN): CCI and static QR"
          },
          "fps_gbp": {
            "allOf": [
              {
                "$ref": "#/components/schemas/FPS_GBP"
              }
            ],
            "description": "FPS instructions for Great Britain (GB)"
          },
          "iban": {
            "title": "Iban",
            "description": "European IBAN",
            "type": "string"
          },
          "bic": {
            "title": "Bic",
            "description": "Swift/BIC code",
            "type": "string"
          }
        },
        "type": "object",
        "title": "Fiat Funding"
      },
      "PenFundingRail": {
        "properties": {
          "cci": {
            "type": "string",
            "title": "Cci"
          },
          "qr": {
            "$ref": "#/components/schemas/PenQrFundingRail"
          }
        },
        "type": "object",
        "required": [
          "cci"
        ],
        "title": "PenFundingRail"
      },
      "PenQrFundingRail": {
        "properties": {
          "qr_code": {
            "type": "string",
            "title": "Qr Code"
          },
          "expiration_date": {
            "type": "string",
            "title": "Expiration Date"
          }
        },
        "type": "object",
        "required": [
          "qr_code",
          "expiration_date"
        ],
        "title": "PenQrFundingRail"
      },
      "PixKeyBrlFundingRail": {
        "properties": {
          "pix_key": {
            "type": "string",
            "title": "Pix Key"
          }
        },
        "type": "object",
        "required": [
          "pix_key"
        ],
        "title": "PixKeyBrlFundingRail"
      },
      "PublicAccountSchema": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id",
            "description": "Account ID"
          },
          "created_at": {
            "title": "Created At",
            "description": "Creation date of the account",
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "title": "Updated At",
            "description": "Last update date of the account",
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountStatus"
              }
            ],
            "description": "Current lifecycle status of the account.",
            "default": "ACTIVE"
          },
          "status_reason": {
            "title": "Status Reason",
            "description": "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.",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "description": "Account label",
            "type": "string"
          },
          "idempotency_key": {
            "title": "Idempotency Key",
            "description": "Idempotency key for the account creation, it can also be used as an external identifier",
            "type": "string"
          },
          "bank": {
            "type": "string",
            "title": "Bank",
            "description": "Name of the bank where the account is held"
          },
          "company_id": {
            "title": "Company Id",
            "description": "Company ID associated with the account",
            "type": "integer"
          },
          "currency": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Currency"
              }
            ],
            "description": "Currency of the account"
          },
          "country": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Country"
              }
            ],
            "description": "Country of the account"
          },
          "account_number": {
            "title": "Account Number",
            "description": "Account number",
            "type": "string"
          },
          "enabled": {
            "type": "boolean",
            "title": "Enabled",
            "description": "Indicates if the account is enabled or not. Disabled accounts will not be able to perform any operations until they are enabled again.",
            "default": true
          },
          "account_type": {
            "title": "Account Type",
            "description": "Type of the account",
            "type": "string"
          },
          "document_number": {
            "title": "Document Number",
            "description": "Document number of the account holder",
            "type": "string"
          },
          "document_type": {
            "title": "Document Type",
            "description": "Document type of the account holder",
            "type": "string"
          },
          "funding_instructions": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FiatFundingInstructions"
              },
              {
                "$ref": "#/components/schemas/CryptoFundingInstructions"
              }
            ],
            "title": "Funding Instructions",
            "description": "Funding instructions for the account, if applicable"
          },
          "balance_details": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BalanceSchema"
              }
            ],
            "description": "Balance details of the account"
          },
          "is_virtual_account": {
            "type": "boolean",
            "title": "Is Virtual Account",
            "description": "Indicates if the account is a virtual account",
            "default": false
          },
          "webhook_url": {
            "title": "Webhook Url",
            "description": "Webhook URL for movement notifications",
            "type": "string"
          },
          "status_callback_url": {
            "title": "Status Callback Url",
            "description": "Callback URL for account-level events",
            "type": "string"
          },
          "products": {
            "items": {
              "$ref": "#/components/schemas/AccountProductsEnum"
            },
            "type": "array",
            "title": "Products",
            "description": "List of products associated with the account",
            "default": []
          },
          "owner_id": {
            "title": "Owner Id",
            "description": "UUID of the Account Owner linked to this account",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "id",
          "bank",
          "currency",
          "country"
        ],
        "title": "PublicAccountSchema"
      },
      "TedBRLFundingRail": {
        "properties": {
          "bank_code": {
            "type": "string",
            "title": "Bank Code"
          },
          "branch_number": {
            "type": "string",
            "title": "Branch Number"
          },
          "account_number": {
            "type": "string",
            "title": "Account Number"
          },
          "account_type": {
            "type": "string",
            "title": "Account Type"
          },
          "beneficiary_name": {
            "type": "string",
            "title": "Beneficiary Name"
          },
          "beneficiary_document": {
            "type": "string",
            "title": "Beneficiary Document"
          }
        },
        "type": "object",
        "required": [
          "bank_code",
          "branch_number",
          "account_number",
          "account_type"
        ],
        "title": "TedBRLFundingRail"
      }
    }
  },
  "webhooks": {
    "account.status_updated": {
      "post": {
        "operationId": "v1_webhook_account_status_updated",
        "summary": "Account status updated",
        "description": "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.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PublicAccountSchema"
              },
              "example": {
                "id": 491,
                "created_at": "2025-09-27T00:02:52.367906",
                "updated_at": "2025-09-27T00:03:10.918273",
                "status": "ACTIVE",
                "label": "Acme MXN account",
                "idempotency_key": "f1e2d3c4-b5a6-9788-8765-4321fedcba98",
                "bank": "STP",
                "company_id": 42,
                "currency": "MXN",
                "country": "MX",
                "account_number": "646180123456789012",
                "enabled": true,
                "account_type": null,
                "document_number": null,
                "document_type": null,
                "funding_instructions": {
                  "type": "fiat",
                  "account_number": "646180123456789012",
                  "bank_name": "STP"
                },
                "balance_details": {
                  "total": 0,
                  "available": 0,
                  "last_update": "2025-09-27T00:03:10.918273"
                },
                "is_virtual_account": true,
                "webhook_url": "https://your-server.com/webhooks/movements",
                "status_callback_url": "https://your-server.com/webhooks/account-status",
                "products": [
                  "PAYINS"
                ],
                "owner_id": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    }
  }
}
```