List insight groups
List groups for which you are collecting insights
### Expanding the insight groups collection response
LaunchDarkly supports expanding the insight groups collection response to include additional fields.
To expand the response, append the `expand` query parameter and include the following:
* `scores` includes details on all of the scores used in the engineering insights metrics views for each group
* `environment` includes details on each environment associated with each group
* `metadata` includes counts of the number of insight groups with particular indicators, such as "excellent," "good," "fair," and so on.
For example, use `?expand=scores` to include the `scores` field in the response. By default, this field is **not** included in the response.
Authentication
Authorizationstring
API Key authentication via header
Query parameters
limit
The number of insight groups to return. Default is 20. Must be between 1 and 20 inclusive.
offset
Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query limit
.
sort
Sort flag list by field. Prefix field with -
to sort in descending order. Allowed fields: name
query
Filter list of insights groups by name.
expand
Options: scores
, environment
, metadata
Response
Insight groups collection response
totalCount
The total number of insight groups
items
A list of insight groups
_links
The location and content type of related resources
metadata
Metadata about the insight groups
scoreMetadata
Metadata about the insight scores, when expanded