# Get all groups paginated

Retrieve all user groups for an account (tenant), with pagination.

Use query parameters to control pagination and optionally include related group data.

Endpoint: GET /resources/groups/v2
Version: 1.0
Security: bearer

## Security:

  - `bearer` (unknown)
    http bearer JWT

## Query parameters:

  - `_groupsRelations` (string)

  - `_limit` (number)

  - `_offset` (number)
    The page number to retrieve. For example, use 0 for the first page, 1 for the second page.

  - `_sortBy` (string)

  - `_order` (string)

## Header parameters:

  - `frontegg-tenant-id` (string)
    The tenant identifier. Required for requests to api.frontegg.com (or your region) when using a management token. Parsed from the token when using user or API tokens

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string, required)

  - `items.name` (string, required)

  - `items.color` (string, required)

  - `items.description` (string, required)

  - `items.metadata` (string, required)

  - `items.roles` (array, required)

  - `items.roles.id` (string, required)

  - `items.roles.vendorId` (string, required)

  - `items.roles.tenantId` (string, required)

  - `items.roles.key` (string, required)

  - `items.roles.name` (string, required)

  - `items.roles.description` (string, required)

  - `items.roles.isDefault` (boolean, required)

  - `items.roles.firstUserRole` (boolean, required)

  - `items.roles.level` (number, required)

  - `items.roles.createdAt` (string, required)

  - `items.roles.updatedAt` (string, required)

  - `items.users` (array, required)

  - `items.users.id` (string, required)

  - `items.users.email` (string, required)

  - `items.users.name` (string, required)

  - `items.users.profilePictureUrl` (string, required)

  - `items.users.createdAt` (string, required)

  - `items.users.activatedForTenant` (boolean, required)

  - `items.managedBy` (string, required)
    Enum: "frontegg", "scim2"

  - `items.createdAt` (string, required)

  - `items.updatedAt` (string, required)

  - `_links` (object)

  - `_links.next` (string, required)

  - `_links.prev` (string, required)

  - `_links.first` (string, required)

  - `_links.last` (string, required)

  - `_metadata` (object)

  - `_metadata.totalItems` (number, required)

  - `_metadata.totalPages` (number, required)

