features

List all features

Changed on

This endpoint retrieves all existing features that represent entitlement components of your application.

get/features

Request

Query parameters

pageinteger
Example:1

Page number. Defaults to 1. A value that is not a positive integer, such as 0, returns the first page.

per_pageinteger
Example:20

Number of records per page. Defaults to 100. The maximum is 200, unless another maximum is configured for your organization. A value above the maximum returns a 422 error with value_is_out_of_range on per_page. A value that is not a positive integer, such as 0, returns the default number of records.

search_termstring
Example:seats

Filter features by search term. The term is matched against the name, the code and the description of the feature.

Response

List of features

Example response

{
  "features": [
    {
      "code": "seats",
      "name": "Number of seats",
      "description": "Number of users of the account",
      "privileges": [
        {
          "code": "max",
          "name": "Maximum",
          "value_type": "integer",
          "config": {}
        },
        {
          "code": "max_admins",
          "name": "Max Admins",
          "value_type": "integer",
          "config": {}
        },
        {
          "code": "root",
          "name": "Allow root user",
          "value_type": "boolean",
          "config": {}
        },
        {
          "code": "provider",
          "name": "SSO Provider",
          "value_type": "select",
          "config": {
            "select_options": [
              "google",
              "okta"
            ]
          }
        }
      ],
      "created_at": "2025-07-17T12:34:35Z"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 4,
    "total_count": 70
  }
}

Changes