---
title: "List Features"
openapi: "openapi POST /v1/features.list"
---

import { DynamicParamField } from "/snippets/dynamic-param-field.jsx";
import { DynamicResponseField } from "/snippets/dynamic-response-field.jsx";
import { DynamicResponseExample } from "/snippets/dynamic-response-example.jsx";


### Response

<DynamicResponseField name="list" type="object[]">
  <Expandable title="properties">
    <DynamicResponseField name="id" type="string">
      The unique identifier for this feature, used in /check and /track calls.
    </DynamicResponseField>

    <DynamicResponseField name="name" type="string">
      Human-readable name displayed in the dashboard and billing UI.
    </DynamicResponseField>

    <DynamicResponseField name="type" type="'boolean' | 'metered' | 'credit_system' | 'ai_credit_system'">
      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.
    </DynamicResponseField>

    <DynamicResponseField name="consumable" type="boolean">
      For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
    </DynamicResponseField>

    <DynamicResponseField name="event_names" type="string[]">
      Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
    </DynamicResponseField>

    <DynamicResponseField name="credit_schema" type="object[]">
      For credit_system features: maps metered features to their credit costs.
      <Expandable title="properties">
        <DynamicResponseField name="metered_feature_id" type="string">
          ID of the metered feature that draws from this credit system.
        </DynamicResponseField>

        <DynamicResponseField name="credit_cost" type="number">
          Credits consumed per unit of the metered feature.
        </DynamicResponseField>

      </Expandable>
    </DynamicResponseField>

    <DynamicResponseField name="model_markups.{key}" type="object | null">
      Per-model markup overrides for AI credit systems.
      <Expandable title="properties">
        <DynamicResponseField name="markup" type="number" />

        <DynamicResponseField name="input_cost" type="number" />

        <DynamicResponseField name="output_cost" type="number" />

      </Expandable>
    </DynamicResponseField>

    <DynamicResponseField name="default_markup" type="number">
      Default percentage markup for AI credit systems. Use -100 to make usage free.
    </DynamicResponseField>

    <DynamicResponseField name="provider_markups.{key}" type="object | null">
      Per-provider default markup percentages for AI credit systems.
      <Expandable title="properties">
        <DynamicResponseField name="markup" type="number" />

      </Expandable>
    </DynamicResponseField>

    <DynamicResponseField name="display" type="object">
      Display names for the feature in billing UI and customer-facing components.
      <Expandable title="properties">
        <DynamicResponseField name="singular" type="string | null">
          Singular form for UI display (e.g., 'API call', 'seat').
        </DynamicResponseField>

        <DynamicResponseField name="plural" type="string | null">
          Plural form for UI display (e.g., 'API calls', 'seats').
        </DynamicResponseField>

      </Expandable>
    </DynamicResponseField>

    <DynamicResponseField name="archived" type="boolean">
      Whether the feature is archived and hidden from the dashboard.
    </DynamicResponseField>

  </Expandable>
</DynamicResponseField>


<ResponseExample>
```json 200
{
  "list": [
    {
      "id": "api-calls",
      "name": "API Calls",
      "type": "metered",
      "consumable": true,
      "archived": false,
      "display": {
        "singular": "API call",
        "plural": "API calls"
      }
    },
    {
      "id": "credits",
      "name": "Credits",
      "type": "credit_system",
      "consumable": true,
      "archived": false,
      "credit_schema": [
        {
          "metered_feature_id": "api-calls",
          "credit_cost": 1
        },
        {
          "metered_feature_id": "image-generations",
          "credit_cost": 10
        }
      ],
      "display": {
        "singular": "credit",
        "plural": "credits"
      }
    }
  ]
}
```
</ResponseExample>