Features

List Features

Retrieve all feature definitions for the merchant. Results are ordered by creation date descending. Supports optional text search across slug and displayName fields.

GET
/features

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Query Parameters

search?string

Optional text search filter. Matches against slug and displayName using case-sensitive LIKE pattern.

Response Body

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/features"

{
  "features": [
    {
      "id": "feat_Lo4xGg1Yk9pB2eWv3sNtA",
      "merchantId": "mer_abc123def456ghi789jkl",
      "slug": "api-access",
      "displayName": "API Access",
      "description": "Access to the REST API",
      "featureType": "boolean",
      "featureValue": true,
      "isOverrideFeature": false,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "deletedAt": null
    },
    {
      "id": "feat_Mn5yHh2Zl0qC3fXw4tOuB",
      "merchantId": "mer_abc123def456ghi789jkl",
      "slug": "max-projects",
      "displayName": "Maximum Projects",
      "description": "Maximum number of projects allowed",
      "featureType": "number",
      "featureValue": 10,
      "isOverrideFeature": false,
      "createdAt": "2024-01-14T09:00:00Z",
      "updatedAt": "2024-01-14T09:00:00Z",
      "deletedAt": null
    }
  ]
}

{
  "error": "Failed to fetch features"
}