import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.get({
featureId: "api-calls",
});from autumn_sdk import Autumn
autumn = Autumn(secret_key="am_sk_test...")
res = autumn.features.get(feature_id="api-calls")curl --request POST \
--url https://api.useautumn.com/v1/features.get \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"feature_id": "api-calls"
}
'{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Get Feature
Retrieves a single feature by its ID.
Use this when you need to fetch the details of a specific feature.
import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.get({
featureId: "api-calls",
});from autumn_sdk import Autumn
autumn = Autumn(secret_key="am_sk_test...")
res = autumn.features.get(feature_id="api-calls")curl --request POST \
--url https://api.useautumn.com/v1/features.get \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-version: <x-api-version>' \
--data '
{
"feature_id": "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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Body
The ID of the feature.
Response
OK
The unique identifier for this feature, used in /check and /track calls.
Human-readable name displayed in the dashboard and billing UI.
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.
boolean, metered, credit_system, ai_credit_system For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
Whether the feature is archived and hidden from the dashboard.
How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
sum, max, min Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
For classic credit systems: maps metered features to flat or graduated credit costs.
- Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes
Per-model markup overrides for AI credit systems.
Show child attributes
Show child attributes
Default percentage markup for AI credit systems. Use -100 to make usage free.
x >= -100Per-provider default markup percentages for AI credit systems.
Show child attributes
Show child attributes
Display names for the feature in billing UI and customer-facing components.
Show child attributes
Show child attributes
Processor mappings for this feature. Present when a Stripe product or meter is set.
Show child attributes
Show child attributes