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

# List Feature Groups

Retrieves a paginated list of feature groups.

## Query

<CodeGroup>
  ```graphql Query theme={null}
  query ListFeatureGroups(
    $filter: FeatureGroupFilter
    $paging: CursorPaging
    $sorting: [FeatureGroupSort!]
  ) {
    featureGroups(filter: $filter, paging: $paging, sorting: $sorting) {
      edges {
        node {
          featureGroupId
          displayName
          description
          status
          versionNumber
          isLatest
          features {
            refId
            displayName
            featureType
          }
        }
        cursor
      }
      pageInfo {
        hasNextPage
        endCursor
      }
      totalCount
    }
  }
  ```

  ```json Variables theme={null}
  {
    "filter": {
      "status": { "eq": "PUBLISHED" },
      "isLatest": { "is": true }
    },
    "paging": {
      "first": 20
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "featureGroups": {
        "edges": [
          {
            "node": {
              "featureGroupId": "group-security",
              "displayName": "Security Features",
              "description": "Enterprise security capabilities",
              "status": "PUBLISHED",
              "versionNumber": 1,
              "isLatest": true,
              "features": [
                {
                  "refId": "feature-sso",
                  "displayName": "Single Sign-On",
                  "featureType": "BOOLEAN"
                },
                {
                  "refId": "feature-2fa",
                  "displayName": "Two-Factor Auth",
                  "featureType": "BOOLEAN"
                }
              ]
            },
            "cursor": "abc123"
          }
        ],
        "pageInfo": {
          "hasNextPage": false,
          "endCursor": "abc123"
        },
        "totalCount": 3
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="filter" type="FeatureGroupFilter">
  Filter criteria for feature groups

  <Expandable title="properties">
    <ParamField body="featureGroupId" type="StringFieldComparison">
      Filter by feature group ID
    </ParamField>

    <ParamField body="status" type="FeatureGroupStatusFilterComparison">
      Filter by status: PUBLISHED, ARCHIVED
    </ParamField>

    <ParamField body="isLatest" type="BooleanFieldComparison">
      Filter to only latest versions
    </ParamField>
  </Expandable>
</ParamField>

## Return Type

Returns a `FeatureGroupConnection` with feature group objects.

## Related Operations

* [Grant Promotional Entitlements](/api-and-sdks/api-reference/mutations/grant-promotional-entitlements) - Grant feature groups