Skip to main content
POST
/
v1
/
features.get
Typescript (SDK)
import { Autumn } from 'autumn-js'

const autumn = new Autumn()

const result = await autumn.features.get({
  featureId: "api-calls",
});
{
  "id": "api-calls",
  "name": "API Calls",
  "type": "metered",
  "consumable": true,
  "archived": false,
  "display": {
    "singular": "API call",
    "plural": "API calls"
  }
}

​
Body Parameters

​
Response

{
  "id": "api-calls",
  "name": "API Calls",
  "type": "metered",
  "consumable": true,
  "archived": false,
  "display": {
    "singular": "API call",
    "plural": "API calls"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-api-version
string
default:2.3.0
required

Body

application/json
​
feature_id
string
required

The ID of the feature.

Response

200 - application/json

OK

​
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
enum<string>
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.

Available options:
boolean,
metered,
credit_system,
ai_credit_system
​
consumable
boolean
required

For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).

​
archived
boolean
required

Whether the feature is archived and hidden from the dashboard.

​
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.

​
model_markups
object

Per-model markup overrides for AI credit systems.

​
default_markup
number

Default percentage markup for AI credit systems. Use -100 to make usage free.

Required range: x >= -100
​
provider_markups
object

Per-provider default markup percentages for AI credit systems.

​
display
object

Display names for the feature in billing UI and customer-facing components.