> ## 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 Features

Retrieves a paginated list of features with optional filtering and sorting.

## Query

<CodeGroup>
  ```graphql Query theme={null}
  query ListFeatures(
    $filter: FeatureFilter
    $paging: CursorPaging
    $sorting: [FeatureSort!]
  ) {
    features(filter: $filter, paging: $paging, sorting: $sorting) {
      edges {
        node {
          refId
          displayName
          description
          featureType
          featureStatus
          featureUnits
          featureUnitsPlural
          hasMeter
          meterType
          enumConfiguration {
            value
            displayName
          }
          meter {
            aggregation
          }
          unitTransformation {
            divide
            round
          }
        }
        cursor
      }
      pageInfo {
        hasNextPage
        endCursor
      }
      totalCount
    }
  }
  ```

  ```json Variables theme={null}
  {
    "filter": {
      "featureStatus": { "eq": "PUBLISHED" }
    },
    "paging": {
      "first": 50
    },
    "sorting": [
      { "field": "displayName", "direction": "ASC" }
    ]
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "features": {
        "edges": [
          {
            "node": {
              "refId": "feature-api-calls",
              "displayName": "API Calls",
              "description": "Number of API calls per month",
              "featureType": "NUMBER",
              "featureStatus": "PUBLISHED",
              "featureUnits": "call",
              "featureUnitsPlural": "calls",
              "hasMeter": true,
              "meterType": "Incremental",
              "enumConfiguration": null,
              "meter": {
                "aggregation": "SUM"
              },
              "unitTransformation": null
            },
            "cursor": "abc123"
          },
          {
            "node": {
              "refId": "feature-sso",
              "displayName": "Single Sign-On",
              "description": "Enable SSO authentication",
              "featureType": "BOOLEAN",
              "featureStatus": "PUBLISHED",
              "featureUnits": null,
              "featureUnitsPlural": null,
              "hasMeter": false,
              "meterType": null,
              "enumConfiguration": null,
              "meter": null,
              "unitTransformation": null
            },
            "cursor": "def456"
          }
        ],
        "pageInfo": {
          "hasNextPage": false,
          "endCursor": "def456"
        },
        "totalCount": 10
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="filter" type="FeatureFilter">
  Filter criteria for features

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

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

    <ParamField body="featureType" type="FeatureTypeFilterComparison">
      Filter by type: BOOLEAN, NUMBER, ENUM
    </ParamField>

    <ParamField body="meterType" type="MeterTypeFilterComparison">
      Filter by meter type: Incremental, Fluctuating
    </ParamField>

    <ParamField body="displayName" type="StringFieldComparison">
      Filter by display name
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="paging" type="CursorPaging">
  Pagination options
</ParamField>

<ParamField body="sorting" type="[FeatureSort]">
  Sorting options with fields: `createdAt`, `displayName`, `refId`
</ParamField>

## Return Type

Returns a `FeatureConnection` with feature objects.

## Common Use Cases

<AccordionGroup>
  <Accordion title="Feature catalog">
    List all features for admin catalog management.
  </Accordion>

  <Accordion title="Plan builder">
    Get available features when building or editing plans.
  </Accordion>
</AccordionGroup>

## Related Operations

* [Create Feature](/api-and-sdks/api-reference/mutations/create-feature) - Create new feature
* [Update Feature](/api-and-sdks/api-reference/mutations/update-feature) - Update feature