Sign in

v1

latestOpenAPI 3.1.02026-07-265817860.8 KB
features

Retrieves a single feature by its ID.

Use this when you need to fetch the details of a specific feature.

post/v1/features.get

Headers

x-api-versionstring required

Request body

feature_idstring required

The ID of the feature.

Example request

{
  "feature_id": "api-calls"
}

Response

OK

idstring required

The unique identifier for this feature, used in /check and /track calls.

namestring required

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

type'boolean' | 'metered' | 'credit_system' | 'ai_credit_system' 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.

consumableboolean required

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

event_namesstring[]

Event names that trigger this feature's balance. Allows multiple features to respond to a single event.

model_markupsobject nullable

Per-model markup overrides for AI credit systems.

default_markupnumber

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

provider_markupsobject nullable

Per-provider default markup percentages for AI credit systems.

archivedboolean required

Whether the feature is archived and hidden from the dashboard.

Example response

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