---
title: "Get Feature Importance for an Analysis Group"
method: GET
path: "/v1/beam/analysis-groups/{group_id}/feature-importance"
tags: ["Analysis Groups"]
---

# Get Feature Importance for an Analysis Group

`GET /v1/beam/analysis-groups/{group_id}/feature-importance`

This endpoint provides Feature Importance results aggregated across the Analyses in an existing Analysis Group, and returns a list of feature groups with associated Features API features and group p-values.

## Path parameters

- `group_id` string, required

## Response `200`

Successful Response

- FeatureImportanceResponse
  - `feature_importance` FeatureGroup[] — A list of feature groups ranked by their statistical significance to the analysis demand data.
    - `feature_group` string, required — The name of the group. This typically aligns to an event category.
    - `features` string[], required — The names of the features in the feature group. These refer directly to features available in Features API.
    - `p_value` number, required — The p-value associated with this feature group for this analysis. It indicates how important the features in the group are in terms of demand. The lower the p-value, the more important the feature group is.
    - `important` boolean, required — A true or false value indicating whether the feature group is considered important for this analysis. Equivalent to `p_value` < 0.1. We suggest using this value to determine whether or not to include this group of features in your modeling.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Bearer token scope insufficient
- `404` — Analysis Group not found

---

[API](https://skmtc.net/predicthq/apis/predicthq-events-api.md) · [All operations](https://skmtc.net/predicthq/apis/predicthq-events-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predicthq/predicthq-events-api/revisions/66cd8ff349dd/schema)