---
title: "Get Virtual Account Metadata"
method: GET
path: "/v3/metadata/collection_accounts/virtual_account"
---

# Get Virtual Account Metadata

`GET /v3/metadata/collection_accounts/virtual_account`

Returns metadata about the virtual accounts that can be created for a given country, currency, and entity. Use this to discover available payment method types, transfer limits, fund transfer networks, and on_behalf_of support.

## Query parameters

- `country` string
- `currencies` string[]
- `entity` string
- `on_behalf_of` boolean

## Response `200`

Virtual account metadata for the given filters.

- object
  - `capabilities` VirtualAccountCapability[] — List of virtual account capabilities available for the given filters.
    - `payment_method_type` string — Type of payment method.
    - `currencies` string[] — Currencies supported by this virtual account type.
    - `transfer_limit` TransferLimit — Minimum and maximum transfer limits.
      - `minimum` object
        - `amount` number
        - `ccy` string
      - `maximum` object
        - `amount` number
        - `ccy` string
      - `currency` string — Currency in which the limits are specified.
    - `on_behalf_of` VirtualAccountOnBehalfOf — on_behalf_of collection support details for a virtual account capability.
      - `support` boolean — Whether on_behalf_of collections can be created.
      - `restricted_industry_verticals` string[] — Industry verticals restricted for on_behalf_of collections.
      - `additional_requirements` string[] — Additional requirements for on_behalf_of collections.
      - `restricted_remitter_countries` string[] — Sender countries restricted for on_behalf_of collections.
      - `restricted_account_holder_countries` string[] — Account holder countries restricted for on_behalf_of collections.
    - `local` object — Local fund transfer network details.
      - `fund_transfer_networks` FundTransferNetwork[] — Fund transfer networks available for this account.
        - `name` string — Name of the fund transfer network.
        - `transfer_limit` TransferLimit — Minimum and maximum transfer limits.
          - `minimum` object
            - `amount` number
            - `ccy` string
          - `maximum` object
            - `amount` number
            - `ccy` string
          - `currency` string — Currency in which the limits are specified.
        - `additional_information` string — Additional info about the network (TAT, availability, etc.).
    - `setup_time` 'instant' | 'same_day' | 't_plus_1' | 't_plus_2' | 't_plus_3' | 'extended' — Time required to set up the virtual account.
    - `account_reenablement_supported` boolean — Whether the account can be re-enabled after being disabled.

---

[API](https://skmtc.net/tazapay/apis/sandbox.md) · [All operations](https://skmtc.net/tazapay/apis/sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tazapay/sandbox/revisions/bf5f4b8f6f5d/schema)