List Features

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

Query

Query

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
  }
}

{
  "filter": {
    "featureStatus": { "eq": "PUBLISHED" }
  },
  "paging": {
    "first": 50
  },
  "sorting": [
    { "field": "displayName", "direction": "ASC" }
  ]
}

{
  "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
    }
  }
}

Parameters

filter · FeatureFilter

Filter criteria for features

Show properties

refId · StringFieldComparison

Filter by feature reference ID

featureStatus · FeatureStatusFilterComparison

Filter by status: PUBLISHED, ARCHIVED

featureType · FeatureTypeFilterComparison

Filter by type: BOOLEAN, NUMBER, ENUM

meterType · MeterTypeFilterComparison

Filter by meter type: Incremental, Fluctuating

displayName · StringFieldComparison

Filter by display name

paging · CursorPaging

Pagination options

sorting · [FeatureSort]

Sorting options with fields: createdAt, displayName, refId

Return Type

Returns a FeatureConnection with feature objects.

Common Use Cases

Feature catalog

List all features for admin catalog management.

Plan builder

Get available features when building or editing plans.

Related Operations

• Create Feature - Create new feature
• Update Feature - Update feature