# List Groups

> Return the account groups available when creating or updating trading accounts.

Source: /admin/accounts-funding/accounts/accounts-service_-account-group-list

## `GET /account-groups`

**List Groups**

Return the account groups available when creating or updating trading accounts.

Tags: `Accounts`

#### Query parameters

- `id` (array)
- `name` (string)
- `currency` (string)
- `status` (string)


### Responses

#### `200` — A successful response.

**Content-Type:** `application/json`

Paginated list of account groups matching the request filters.
- `groups` (array)
  - items:
    - `id` (string)
    - `marginCallLevel` (number)
    - `stopOutLevel` (number)
    - `description` (string)
    - `name` (string)
    - `negativeBalanceProtect` (boolean)
    - `status` (string)
      - enum: `TRADE_STATUS_UNSPECIFIED`, `TRADE_STATUS_FULL`, `TRADE_STATUS_CLOSE_ONLY`, `TRADE_STATUS_DISABLED`, `TRADE_STATUS_LONG_ONLY`
    - `externalGatewayId` (string) — Deprecated: routing decisions are owned by RoutingService; this field is no longer consulted.
    - `permissions` (array)
      - items:
        - `id` (string)
        - `enabled` (boolean)
        - `groupId` (string)
        - `symbolId` (string)
        - `marginTemplateId` (string)
        - `commissionTemplateId` (string)
        - `volumeTemplateId` (string)
        - `protectionTemplateId` (string)
        - `markupBid` (string)
        - `markupAsk` (string)
        - `maxNop` (string)
        - `status` (string)
          - enum: `TRADE_STATUS_UNSPECIFIED`, `TRADE_STATUS_FULL`, `TRADE_STATUS_CLOSE_ONLY`, `TRADE_STATUS_DISABLED`, `TRADE_STATUS_LONG_ONLY`
    - `swapFree` (boolean)
    - `isDemo` (boolean)
    - `symbolProfileId` (string)
    - `marginCalculationType` (string) — MarginCalculationType defines how opposing positions on the same symbol are combined.

 - MARGIN_CALC_TYPE_UNSPECIFIED: unspecified — behaves as SUM
 - MARGIN_CALC_TYPE_SUM: long_margin + short_margin (most conservative)
 - MARGIN_CALC_TYPE_MAX: max(long_margin, short_margin) — partial hedging relief
 - MARGIN_CALC_TYPE_NET: margin on abs(long_qty - short_qty) — full hedging offset
      - enum: `MARGIN_CALC_TYPE_UNSPECIFIED`, `MARGIN_CALC_TYPE_SUM`, `MARGIN_CALC_TYPE_MAX`, `MARGIN_CALC_TYPE_NET`
    - `marginRecalcScope` (string)
      - enum: `MARGIN_RECALC_SCOPE_UNSPECIFIED`, `MARGIN_RECALC_SCOPE_SYMBOL_IMPACT`, `MARGIN_RECALC_SCOPE_FULL`
    - `fundingProfileId` (string)
    - `statementHeading` (string)
- `page` (string)
- `perPage` (string)
- `total` (string)

#### `default` — An unexpected error response.

**Content-Type:** `application/json`

- `code` (integer)
- `message` (string)
- `details` (array)
  - items:
    - `@type` (string)