---
title: "POST /v1/features.list"
method: POST
path: "/v1/features.list"
tags: ["features"]
---

# POST /v1/features.list

`POST /v1/features.list`

Lists all features in the current environment.

Use this to retrieve all features configured for your organization to display in dashboards or for feature management.

## Headers

- `x-api-version` string, required

## Response `200`

OK

- object
  - `list` object[], required
    - `id` string, required — The unique identifier for this feature, used in /check and /track calls.
    - `name` string, required — Human-readable name displayed in the dashboard and billing UI.
    - `type` 'boolean' | 'metered' | 'credit_system' | 'ai_credit_system', required — Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.
    - `consumable` boolean, required — For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
    - `event_names` string[] — Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
    - `credit_schema` object[] — For credit_system features: maps metered features to their credit costs.
      - `metered_feature_id` string, required — ID of the metered feature that draws from this credit system.
      - `credit_cost` number, required — Credits consumed per unit of the metered feature.
    - `model_markups` object, nullable — Per-model markup overrides for AI credit systems.
    - `default_markup` number — Default percentage markup for AI credit systems. Use -100 to make usage free.
    - `provider_markups` object, nullable — Per-provider default markup percentages for AI credit systems.
    - `display` object — Display names for the feature in billing UI and customer-facing components.
      - `singular` string, nullable — Singular form for UI display (e.g., 'API call', 'seat').
      - `plural` string, nullable — Plural form for UI display (e.g., 'API calls', 'seats').
    - `archived` boolean, required — Whether the feature is archived and hidden from the dashboard.

---

[API](https://skmtc.net/useautumn/apis/autumn-api.md) · [All operations](https://skmtc.net/useautumn/apis/autumn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useautumn/autumn-api/revisions/29536933c0dc/schema)