Get Feature

Retrieve a single feature by its ID

Overview

Retrieve detailed information about a specific feature, including its type, configuration, and display settings.

Endpoint

POST /v1/features.get

Request Body

feature_id · string · required

The unique identifier of the feature to retrieve.

Example: "api-calls", "seats", "credits"

Response

Returns the feature object.

id · string

The unique identifier for this feature.

name · string

Human-readable name displayed in the dashboard and billing UI.

type · enum

Feature type: "boolean", "metered", or "credit_system".

consumable · boolean

Whether the feature is consumable. true for features that reset periodically, false for persistent allocations.

archived · boolean

Whether the feature is archived and hidden from the dashboard.

display · object

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

Show properties

singular · string

Singular form for UI display (e.g., “API call”, “seat”).

plural · string

Plural form for UI display (e.g., “API calls”, “seats”).

credit_schema · array

Credit schema mapping (only present for credit_system features).

Show properties

metered_feature_id · string

ID of the metered feature that draws from this credit system.

credit_cost · number

Credits consumed per unit of the metered feature.

event_names · array

Event names that trigger this feature’s balance.

Examples

Node.js

const response = await fetch('https://api.autumn.com/v1/features.get', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    feature_id: 'api-calls'
  })
});

const feature = await response.json();
console.log(feature);

import requests

response = requests.post(
    'https://api.autumn.com/v1/features.get',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={'feature_id': 'api-calls'}
)

feature = response.json()
print(feature)

curl -X POST https://api.autumn.com/v1/features.get \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"feature_id": "api-calls"}'

Get Metered Feature

Request

{
  "feature_id": "api-calls"
}

Response

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

Get Credit System Feature

Request

{
  "feature_id": "credits"
}

Response

{
  "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"
  }
}

Get Boolean Feature

Request

{
  "feature_id": "advanced-analytics"
}

Response

{
  "id": "advanced-analytics",
  "name": "Advanced Analytics",
  "type": "boolean",
  "consumable": false,
  "archived": false
}

Use Cases

Feature Validation

Verify a feature exists and retrieve its configuration before using it in /track or /check calls.

Dashboard Display

Fetch feature details to display in your admin dashboard or customer portal.

Configuration Sync

Keep your local feature definitions in sync with your Autumn configuration.

Pricing Display

Retrieve feature names and display settings to show in pricing tables.

Error Responses

code · string

Error code identifying the type of error.

message · string

Human-readable error message.

Common Errors

• feature_not_found - No feature exists with this ID
• invalid_feature_id - Feature ID format is invalid