> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Group Types

> List the virtual account group types that can be opened for an account

Works on any account you own. [Create Virtual Account Group](/fx/api-reference/virtual-account-groups/create-group) covers who can open a group and what the account needs first.

A virtual account group tracks an account's onboarding requirements, approval, and activation for a group type. Before you can create virtual accounts under the group, its `onboarding_status` must be `approved` and its `status` must be `enabled`.

You can onboard the same account for multiple group types, with one group per type. Each group is onboarded and enabled separately, and each virtual account belongs to one group.

This endpoint lists the group types available to open. The list is the same for every customer in an environment. The `customer_id` in the path scopes the call to your customer; it does not filter the catalogue.

Take `type` from an entry here and pass it as the `type` body field of [Create Virtual Account Group](/fx/api-reference/virtual-account-groups/create-group).

The response is a plain `{"items": [...]}` object. It is **not** paginated, carries no `page`, `size`, `total` or `pages`, and takes no query parameters.

Requires an API key with `read` access on the `virtual_accounts` scope.

## Path Parameters

<ParamField path="customer_id" type="string" required>
  The customer's external ID (starts with `cus_`)
</ParamField>

## Response

<ResponseField name="items" type="array">
  Group type objects. The order follows Hop's configuration and is stable within an environment.

  <Expandable title="Group Type Fields">
    <ResponseField name="object" type="string">
      Always returns `"virtual_account_group_type"`
    </ResponseField>

    <ResponseField name="type" type="string">
      Stable identifier of the type, for example `business_virtual_accounts`, and the value to send to [Create Virtual Account Group](/fx/api-reference/virtual-account-groups/create-group).
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name for the type
    </ResponseField>

    <ResponseField name="description" type="string">
      Product description, or `null` when the type carries none
    </ResponseField>

    <ResponseField name="currencies" type="array">
      Currency codes a virtual account under this group may be opened in, for example `["USD", "EUR", "GBP"]`. An empty array means no currency is configured for the type.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| Status | `code` | When |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | `customer_id` is unknown or is not your customer |

## Request Example

```bash theme={null}
curl "https://api.hopnow.io/v1/customers/cus_8xq2m4v7r1t5w9p3k6n0z2bd/virtual-account-group-types" \
  -H "X-API-Key: your_api_key" \
  -H "X-Signature: hmac_signature" \
  -H "X-Timestamp: 1234567890" \
  -H "X-Nonce: abc123"
```

## Response Example

```json theme={null}
{
  "items": [
    {
      "object": "virtual_account_group_type",
      "type": "business_virtual_accounts",
      "name": "Business Virtual Accounts",
      "description": null,
      "currencies": ["USD", "EUR", "GBP"]
    }
  ]
}
```