Overview
List all features configured in your Autumn environment. This returns both active and archived features with their full configuration.
Endpoint
Request Body
This endpoint does not require any request parameters.
Response
Returns a list of all feature objects.
Array of feature objects.Show Feature Object Properties
The unique identifier for this feature.
Human-readable name of the feature.
Feature type: "boolean", "metered", or "credit_system".
Whether the feature is consumable.
Whether the feature is archived.
Display names for UI rendering.
Credit schema mapping (only for credit_system features).
Event names that trigger this feature.
Examples
const response = await fetch('https://api.autumn.com/v1/features.list', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({})
});
const { list } = await response.json();
console.log('Total features:', list.length);
console.log(list);
Response Example
{
"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"
}
},
{
"id": "advanced-analytics",
"name": "Advanced Analytics",
"type": "boolean",
"consumable": false,
"archived": false
},
{
"id": "seats",
"name": "Team Seats",
"type": "metered",
"consumable": false,
"archived": false,
"display": {
"singular": "seat",
"plural": "seats"
}
}
]
}
Use Cases
Dashboard Overview
Display all available features in your admin dashboard for management and configuration.
Pricing Pages
Populate pricing comparison tables by listing all features and their configurations.
Feature Discovery
Discover what features are available in your environment during development.
Configuration Export
Export your complete feature configuration for backup or migration purposes.
Filtering Results
The list includes both active and archived features. You can filter the results in your application:
const { list } = await response.json();
const activeFeatures = list.filter(f => !f.archived);
const { list } = await response.json();
const grouped = {
boolean: list.filter(f => f.type === 'boolean'),
metered: list.filter(f => f.type === 'metered'),
credit_system: list.filter(f => f.type === 'credit_system')
};
const { list } = await response.json();
const consumableFeatures = list.filter(f => f.consumable);
list property containing an array of features. If no features are configured, the array will be empty:
Archived features are included in the response. Filter them out in your application if you only need active features.
Cache the feature list in your application to reduce API calls. Refresh when you create, update, or delete features.