---
updatedAt: 2026-06-04T14:48:28.000Z
agentTools:
  projectIndex: https://docs.infiniaweb.com/llms.txt
---

# Get Account Limits & Usage

Returns the current monthly volume used and configured limit for the account.

# 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"
    }
  ],
  "paths": {
    "/{account_id}/limits/": {
      "get": {
        "tags": [
          "Accounts"
        ],
        "summary": "Get Account Limits & Usage",
        "description": "Returns the current monthly volume used and configured limit for the account.",
        "operationId": "v1_5_get_account_limits_",
        "security": [
          {
            "HTTPBasic": []
          }
        ],
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Account Id"
            }
          },
          {
            "name": "x-company-id",
            "in": "header",
            "required": false,
            "schema": {
              "description": "ID of a child company for authentication. If not provided, the parent company will be authenticated.",
              "title": "X-Company-Id",
              "type": "integer"
            },
            "description": "ID of a child company for authentication. If not provided, the parent company will be authenticated."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountLimitsResponse"
                }
              }
            }
          },
          "403": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Forbidden"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Not Found"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AccountLimitsData": {
        "properties": {
          "monthly": {
            "$ref": "#/components/schemas/MonthlyUsage"
          }
        },
        "type": "object",
        "required": [
          "monthly"
        ],
        "title": "AccountLimitsData"
      },
      "AccountLimitsResponse": {
        "properties": {
          "status": {
            "type": "string",
            "title": "Status",
            "default": "success",
            "enum": [
              "success"
            ]
          },
          "data": {
            "$ref": "#/components/schemas/AccountLimitsData"
          }
        },
        "type": "object",
        "required": [
          "data"
        ],
        "title": "AccountLimitsResponse"
      },
      "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"
      },
      "CompanyToIncludeInResponses": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "title": "CompanyToIncludeInResponses"
      },
      "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"
      },
      "CryptoType": {
        "type": "string",
        "enum": [
          "CRYPTO"
        ],
        "title": "CryptoType"
      },
      "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"
      },
      "DepositRefundResponse": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Refund ID"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation date of the refund"
          },
          "updated_at": {
            "title": "Updated At",
            "description": "Last update date of the refund",
            "type": "string",
            "format": "date-time"
          },
          "idempotency_key": {
            "title": "Idempotency Key",
            "description": "Idempotency key for the refund request, it can also be used as an external identifier",
            "type": "string",
            "maxLength": 128
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "SUCCESS",
              "FAILED"
            ],
            "title": "Status",
            "description": "Status of the refund"
          },
          "description": {
            "title": "Description",
            "description": "Description for the refund. If supported by the rail, this will be forwarded to the end user.",
            "type": "string"
          },
          "debit_movement_id": {
            "title": "Debit Movement Id",
            "description": "Debit movement that was originated from the refund",
            "type": "integer"
          },
          "bounce_movement_id": {
            "title": "Bounce Movement Id",
            "description": "Credit movement that was originated from the refund bounce, if applicable",
            "type": "integer"
          },
          "company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyToIncludeInResponses"
              }
            ],
            "description": "Company associated with the refund"
          },
          "voucher_id": {
            "title": "Voucher Id",
            "description": "Voucher ID associated with the refund, if applicable",
            "type": "string"
          },
          "failure_reason": {
            "title": "Failure Reason",
            "description": "Reason for refund failure, if applicable",
            "type": "string"
          },
          "movement_id": {
            "type": "integer",
            "title": "Movement Id",
            "description": "Movement ID that was refunded"
          }
        },
        "type": "object",
        "required": [
          "id",
          "created_at",
          "status",
          "movement_id"
        ],
        "title": "Refund Response"
      },
      "ErrorResponse": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "error",
              "fail"
            ],
            "title": "Status",
            "default": "error"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "error_code": {
            "title": "Error Code",
            "type": "string"
          },
          "trace_id": {
            "title": "Trace Id",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "Error Response"
      },
      "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"
      },
      "FiatType": {
        "type": "string",
        "enum": [
          "FIAT"
        ],
        "title": "FiatType"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "MonthlyUsage": {
        "properties": {
          "used": {
            "type": "number",
            "title": "Used"
          },
          "limit": {
            "title": "Limit",
            "type": "number"
          },
          "remaining": {
            "title": "Remaining",
            "type": "number"
          },
          "resets_at": {
            "type": "string",
            "format": "date-time",
            "title": "Resets At"
          }
        },
        "type": "object",
        "required": [
          "used",
          "resets_at"
        ],
        "title": "MonthlyUsage"
      },
      "MovmentOperation": {
        "properties": {
          "type": {
            "allOf": [
              {
                "$ref": "#/components/schemas/OperationType"
              }
            ],
            "description": "Name of the operation"
          },
          "operation_id": {
            "title": "Operation Id",
            "description": "ID of the operation",
            "type": "string"
          },
          "product": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Product"
              }
            ],
            "description": "Product of the operation"
          }
        },
        "type": "object",
        "required": [
          "type"
        ],
        "title": "Operation"
      },
      "OperationType": {
        "type": "string",
        "enum": [
          "PAYOUT",
          "PAYOUT_REFUND",
          "INTERNAL_TRANSFER",
          "INTERNAL_TRANSFER_REFUND",
          "PAYIN",
          "PAYIN_REFUND",
          "PAYIN_REFUND_BOUNCE",
          "CREDIT",
          "CREDIT_REFUND",
          "CREDIT_REFUND_BOUNCE",
          "DEBIT",
          "FEE",
          "TAX",
          "ORDER_FUNDING",
          "ORDER_DELIVERY",
          "ORDER_RECOVERY",
          "ORDER_REFUND",
          "EXCHANGE_OUT",
          "EXCHANGE_IN",
          "LOAN_OUT",
          "LOAN_FUNDING"
        ],
        "title": "OperationType"
      },
      "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"
      },
      "Product": {
        "type": "string",
        "enum": [
          "PAYOUTS",
          "PAYINS",
          "INTERNAL_TRANSFER",
          "ACCOUNTS"
        ],
        "title": "Product"
      },
      "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"
      },
      "ShowableMovement": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Movement ID"
          },
          "account_id": {
            "type": "string",
            "title": "Account Id",
            "description": "Account ID"
          },
          "company_id": {
            "type": "string",
            "title": "Company Id",
            "description": "Company ID"
          },
          "amount": {
            "type": "number",
            "title": "Amount",
            "description": "Amount of the movement"
          },
          "currency": {
            "title": "Currency",
            "description": "Currency of the movement",
            "type": "string"
          },
          "country": {
            "title": "Country",
            "description": "Country of the movement",
            "type": "string"
          },
          "balance": {
            "title": "Balance",
            "description": "Balance after the movement",
            "type": "number"
          },
          "description": {
            "title": "Description",
            "description": "Description of the movement",
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation date of the movement"
          },
          "updated_at": {
            "title": "Updated At",
            "description": "Last update date of the movement",
            "type": "string",
            "format": "date-time"
          },
          "third_party": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ThirdPartyDataFiatMovement"
              },
              {
                "$ref": "#/components/schemas/ThirdPartyCryptoMovement"
              }
            ],
            "title": "Third Party",
            "description": "Third party data of the movement"
          },
          "operation": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MovmentOperation"
              }
            ],
            "description": "Operation of the movement"
          },
          "company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyToIncludeInResponses"
              }
            ],
            "description": "Company associated with the movement"
          },
          "claim_id": {
            "title": "Claim Id",
            "description": "Claim ID associated with the movement",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "id",
          "account_id",
          "company_id",
          "amount",
          "created_at"
        ],
        "title": "ShowableMovement"
      },
      "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"
      },
      "ThirdPartyCryptoMovement": {
        "properties": {
          "type": {
            "$ref": "#/components/schemas/CryptoType"
          },
          "crypto_address": {
            "title": "Crypto Address",
            "type": "string"
          },
          "crypto_network": {
            "title": "Crypto Network",
            "type": "string"
          },
          "transaction_hash": {
            "title": "Transaction Hash",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "type"
        ],
        "title": "CRYPTO"
      },
      "ThirdPartyDataFiatMovement": {
        "properties": {
          "type": {
            "$ref": "#/components/schemas/FiatType"
          },
          "voucher_id": {
            "title": "Voucher Id",
            "type": "string"
          },
          "source_reference": {
            "title": "Source Reference",
            "type": "string"
          },
          "bank_code": {
            "title": "Bank Code",
            "type": "string"
          },
          "bank_name": {
            "title": "Bank Name",
            "type": "string"
          },
          "account_number": {
            "title": "Account Number",
            "type": "string"
          },
          "full_name": {
            "title": "Full Name",
            "type": "string"
          },
          "document_number": {
            "title": "Document Number",
            "type": "string"
          },
          "document_type": {
            "title": "Document Type",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "type"
        ],
        "title": "FIAT"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "AccountToIncludeInResponses": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "account_number": {
            "type": "string",
            "title": "Account Number"
          },
          "currency": {
            "type": "string",
            "title": "Currency"
          },
          "country": {
            "type": "string",
            "title": "Country"
          },
          "company": {
            "$ref": "#/components/schemas/CompanyToIncludeInResponses"
          }
        },
        "type": "object",
        "required": [
          "id",
          "account_number",
          "currency",
          "country",
          "company"
        ],
        "title": "AccountToIncludeInResponses"
      },
      "FxQuoteLimitsWarning": {
        "properties": {
          "rule_code": {
            "type": "string",
            "title": "Rule Code",
            "description": "Provider account limit rule the quote would break"
          },
          "message": {
            "type": "string",
            "title": "Message",
            "description": "Why the internal transfer may be rejected when the quote is executed"
          }
        },
        "type": "object",
        "required": [
          "rule_code",
          "message"
        ],
        "title": "FxQuoteLimitsWarning"
      },
      "GetFxQuoteResult": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Quote ID"
          },
          "company_id": {
            "title": "Company Id",
            "description": "Company ID",
            "type": "string"
          },
          "external_id": {
            "title": "External Id",
            "description": "External ID of the quote",
            "type": "string"
          },
          "source_amount": {
            "title": "Source Amount",
            "description": "Amount to transfer from source to target account (in source account currency)",
            "type": "string"
          },
          "target_amount": {
            "title": "Target Amount",
            "description": "Amount to receive in the target account currency (in target account currency)",
            "type": "string"
          },
          "status": {
            "type": "string",
            "title": "Status",
            "description": "Status of the quote"
          },
          "failure_reason": {
            "title": "Failure Reason",
            "description": "Reason of the failure, if applicable",
            "type": "string"
          },
          "limits_warning": {
            "allOf": [
              {
                "$ref": "#/components/schemas/FxQuoteLimitsWarning"
              }
            ],
            "description": "Set when the banking partner's account limits would reject executing this quote. Informative: the quote is still ACTIVE. Only returned when the quote is created."
          },
          "source_account_id": {
            "type": "string",
            "title": "Source Account Id",
            "description": "Source account ID"
          },
          "target_account_id": {
            "type": "string",
            "title": "Target Account Id",
            "description": "Target account ID"
          },
          "rate": {
            "title": "Rate",
            "description": "FX rate",
            "type": "string"
          },
          "expire_at": {
            "title": "Expire At",
            "description": "Expiration date of the rate",
            "type": "string",
            "format": "date-time"
          },
          "created_at": {
            "title": "Created At",
            "description": "Creation date of the quote",
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "title": "Updated At",
            "description": "Last update date of the quote",
            "type": "string",
            "format": "date-time"
          },
          "callback_url": {
            "title": "Callback Url",
            "description": "URL to send a POST request with the result of the quote. The schema of the POST request is the same as the response of this endpoint",
            "type": "string"
          },
          "company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyToIncludeInResponses"
              }
            ],
            "description": "Company details"
          },
          "source_account": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountToIncludeInResponses"
              }
            ],
            "description": "Source account details"
          },
          "target_account": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountToIncludeInResponses"
              }
            ],
            "description": "Target account details"
          }
        },
        "type": "object",
        "required": [
          "id",
          "company_id",
          "source_amount",
          "status",
          "source_account_id",
          "target_account_id",
          "company",
          "source_account",
          "target_account"
        ],
        "title": "GetFxQuoteResult"
      },
      "InternalTransferResult": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "Transfer ID"
          },
          "idempotency_key": {
            "title": "Idempotency Key",
            "description": "A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.",
            "type": "string"
          },
          "company_id": {
            "type": "string",
            "title": "Company Id",
            "description": "Company ID"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At",
            "description": "Creation date of the transfer"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At",
            "description": "Last update date of the transfer"
          },
          "quote_id": {
            "title": "Quote Id",
            "description": "Quote request ID used in the transfer, if applicable",
            "type": "string"
          },
          "rate": {
            "title": "Rate",
            "description": "FX rate used in the transfer, if applicable",
            "type": "number"
          },
          "source_amount": {
            "title": "Source Amount",
            "description": "Amount of the transfer",
            "type": "number"
          },
          "destination_amount": {
            "title": "Destination Amount",
            "description": "Amount received in the target account currency",
            "type": "number"
          },
          "source_account_id": {
            "type": "string",
            "title": "Source Account Id",
            "description": "Source account ID"
          },
          "target_account_id": {
            "type": "string",
            "title": "Target Account Id",
            "description": "Target account ID"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/InternalTransferStatus"
              }
            ],
            "description": "Status of the transfer"
          },
          "failure_reason": {
            "title": "Failure Reason",
            "description": "Reason of the failure, if the transfer failed",
            "type": "string"
          },
          "compliance_hold": {
            "type": "boolean",
            "title": "Compliance Hold",
            "description": "True while the transfer is temporarily held for a compliance review. The transfer resumes automatically once the review is completed.",
            "default": false
          },
          "callback_url": {
            "title": "Callback Url",
            "description": "URL to send a POST request with the result of the transfer, if applicable",
            "type": "string"
          },
          "voucher_ids": {
            "title": "Voucher Ids",
            "description": "Voucher IDs associated with the transfer of funds to the final destination.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "source_account": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountToIncludeInResponses"
              }
            ],
            "description": "Source account details"
          },
          "target_account": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AccountToIncludeInResponses"
              }
            ],
            "description": "Target account details"
          },
          "company": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CompanyToIncludeInResponses"
              }
            ],
            "description": "Company details"
          }
        },
        "type": "object",
        "required": [
          "id",
          "company_id",
          "created_at",
          "updated_at",
          "source_account_id",
          "target_account_id",
          "status",
          "source_account",
          "company"
        ],
        "title": "InternalTransferResult"
      },
      "InternalTransferStatus": {
        "type": "string",
        "enum": [
          "PENDING",
          "PROCESSING",
          "SETTLING",
          "COMPLETED",
          "FAILED"
        ],
        "title": "InternalTransferStatus"
      }
    },
    "securitySchemes": {
      "HTTPBasic": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "webhooks": {
    "internal_transfer.updated": {
      "post": {
        "operationId": "v1_webhook_internal_transfer_updated",
        "summary": "Internal transfer updated",
        "description": "Sent when an internal transfer changes status (`PENDING` → `PROCESSING` → `COMPLETED`, `FAILED`, etc.). Set the destination URL using `callback_url` when creating the transfer. The body is identical to the [Get Internal Transfer](ref:v1_11_get_internal_transfer) response.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InternalTransferResult"
              },
              "example": {
                "id": "a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6",
                "idempotency_key": "f1e2d3c4-b5a6-9788-8765-4321fedcba98",
                "company_id": "42",
                "created_at": "2025-10-15T14:21:32.351798",
                "updated_at": "2025-10-15T14:24:28.902382",
                "quote_id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
                "rate": 5.41,
                "source_amount": 16.64,
                "destination_amount": 90,
                "source_account_id": "4565",
                "target_account_id": "7202",
                "status": "COMPLETED",
                "failure_reason": null,
                "callback_url": "https://your-server.com/webhooks/transfers",
                "voucher_ids": [
                  "0xabcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890"
                ],
                "source_account": {
                  "id": "4565",
                  "account_number": "2e22a9cc-5703-481c-960e-000000000001",
                  "currency": "USDC",
                  "country": "XX",
                  "company": {
                    "id": "42",
                    "name": "Acme Corp"
                  }
                },
                "target_account": {
                  "id": "7202",
                  "account_number": "6180656d-4736-447e-b298-000000000002",
                  "currency": "BRL",
                  "country": "BR",
                  "company": {
                    "id": "42",
                    "name": "Acme Corp"
                  }
                },
                "company": {
                  "id": "42",
                  "name": "Acme Corp"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    },
    "movement.created": {
      "post": {
        "operationId": "v1_webhook_movement_created",
        "summary": "Movement created",
        "description": "Sent when a new movement (credit or debit) is recorded on an account. The body is identical to an item from the [Get Movements](ref:v1_5_get_movements) response.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ShowableMovement"
              },
              "example": {
                "id": "7643753",
                "account_id": "189075",
                "company_id": "42",
                "amount": 50000,
                "currency": "ARS",
                "country": "AR",
                "balance": 50000,
                "description": "VOUCHER123|Juan Pérez|12345678901",
                "created_at": "2026-03-05T09:11:06.917875",
                "updated_at": "2026-03-05T09:11:06.917875",
                "third_party": {
                  "type": "FIAT",
                  "voucher_id": "VOUCHER123",
                  "source_reference": "VOUCHER123",
                  "bank_code": null,
                  "bank_name": "MERCADO LIBRE SRL",
                  "account_number": "0000003100100000000001",
                  "full_name": "Juan Pérez",
                  "document_number": "12345678901",
                  "document_type": "CUIT"
                },
                "operation": {
                  "type": "CREDIT",
                  "operation_id": null,
                  "product": null
                },
                "company": {
                  "id": "42",
                  "name": "Acme Corp"
                },
                "claim_id": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    },
    "deposit_refund.updated": {
      "post": {
        "operationId": "v1_webhook_deposit_refund_updated",
        "summary": "Deposit refund updated",
        "description": "Sent when a deposit refund changes status. The body is identical to an item from the [List Deposit Refunds](ref:v1_7_list_deposit_refunds) response.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DepositRefundResponse"
              },
              "example": {
                "id": "ref_01HXYZ",
                "created_at": "2024-05-30T11:00:00Z",
                "updated_at": "2024-05-30T11:05:00Z",
                "status": "SUCCESS",
                "movement_id": 9001,
                "company": {
                  "id": 42,
                  "name": "Acme Corp"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    },
    "fx_quote.updated": {
      "post": {
        "operationId": "v1_webhook_fx_quote_updated",
        "summary": "FX quote updated",
        "description": "Sent when an FX quote changes status (`ACTIVE` → `COMPLETED`, `FAILED`, `EXPIRED`, etc.). Set the destination URL using `callback_url` when creating the quote. The body is identical to the [Get FX Quote](ref:v1_8_get_quote) response.",
        "tags": [
          "Webhooks"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetFxQuoteResult"
              },
              "example": {
                "id": "c3d4e5f6-a7b8-9c0d-1e2f-3a4b5c6d7e8f",
                "company_id": "42",
                "external_id": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
                "source_amount": 548.31,
                "target_amount": 10104.09,
                "status": "ACTIVE",
                "failure_reason": null,
                "source_account_id": "582",
                "target_account_id": "4962",
                "rate": 18.4277,
                "expire_at": "2025-10-13T21:26:29.813000",
                "created_at": "2025-10-13T21:26:17.741252",
                "updated_at": "2025-10-13T21:26:20.090921",
                "callback_url": "https://your-server.com/webhooks/fx-quotes",
                "company": {
                  "id": "42",
                  "name": "Acme Corp"
                },
                "source_account": {
                  "id": "582",
                  "account_number": "dfe2aeec-bead-4c95-97dc-000000000001",
                  "currency": "USDC",
                  "country": "XX",
                  "company": {
                    "id": "42",
                    "name": "Acme Corp"
                  }
                },
                "target_account": {
                  "id": "4962",
                  "account_number": "646180546701090001",
                  "currency": "MXN",
                  "country": "MX",
                  "company": {
                    "id": "42",
                    "name": "Acme Corp"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
          }
        }
      }
    },
    "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."
          }
        }
      }
    }
  }
}
```