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

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

## Query

<CodeGroup>
  ```graphql Query theme={null}
  query ListAddons(
    $filter: AddonFilter
    $paging: CursorPaging
    $sorting: [AddonSort!]
  ) {
    addons(filter: $filter, paging: $paging, sorting: $sorting) {
      edges {
        node {
          refId
          displayName
          description
          status
          pricingType
          maxQuantity
          versionNumber
          product {
            refId
            displayName
          }
          prices {
            billingModel
            billingPeriod
            price {
              amount
              currency
            }
          }
          packageEntitlements {
            ... on PackageEntitlement {
              feature {
                refId
                displayName
              }
              usageLimit
            }
          }
          dependencies {
            refId
            displayName
          }
        }
        cursor
      }
      pageInfo {
        hasNextPage
        endCursor
      }
      totalCount
    }
  }
  ```

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

  ```json Response theme={null}
  {
    "data": {
      "addons": {
        "edges": [
          {
            "node": {
              "refId": "addon-extra-seats",
              "displayName": "Extra Seats",
              "description": "Add more team members",
              "status": "PUBLISHED",
              "pricingType": "PAID",
              "maxQuantity": 100,
              "versionNumber": 2,
              "product": {
                "refId": "product-main",
                "displayName": "Main Product"
              },
              "prices": [
                {
                  "billingModel": "FLAT_FEE",
                  "billingPeriod": "MONTHLY",
                  "price": {
                    "amount": 10,
                    "currency": "USD"
                  }
                }
              ],
              "packageEntitlements": [
                {
                  "feature": {
                    "refId": "feature-seats",
                    "displayName": "Team Seats"
                  },
                  "usageLimit": 1
                }
              ],
              "dependencies": []
            },
            "cursor": "abc123"
          }
        ],
        "pageInfo": {
          "hasNextPage": false,
          "endCursor": "abc123"
        },
        "totalCount": 3
      }
    }
  }
  ```
</CodeGroup>

## Parameters

<ParamField body="filter" type="AddonFilter">
  Filter criteria for addons

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

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

    <ParamField body="pricingType" type="PricingTypeFilterComparison">
      Filter by pricing type: FREE, PAID, CUSTOM
    </ParamField>

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

    <ParamField body="productId" type="StringFieldComparison">
      Filter by product ID
    </ParamField>
  </Expandable>
</ParamField>

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

<ParamField body="sorting" type="[AddonSort]">
  Sorting options
</ParamField>

## Return Type

Returns an `AddonConnection` with addon objects.

## Related Operations

* [Get Addon](/api-and-sdks/api-reference/queries/get-addon) - Get single addon
* [Create Addon](/api-and-sdks/api-reference/mutations/create-addon) - Create new addon