---
title: "GET /v1beta/projects/{project}/alerts:enumerateFacets"
method: GET
path: "/v1beta/projects/{project}/alerts:enumerateFacets"
tags: ["threatintelligence"]
---

# GET /v1beta/projects/{project}/alerts:enumerateFacets

`GET /v1beta/projects/{project}/alerts:enumerateFacets`

EnumerateAlertFacets returns the facets and the number of alerts that meet
the filter criteria and have that value for each facet.

## Path parameters

- `project` string, required

## Query parameters

- `filter` string

## Headers

- `x-goog-user-project` string, required

## Response `default`

Successful operation

- EnumerateAlertFacetsResponse — Response message for EnumerateAlertFacets.
  - `facets` Facet[] — List of facets and the counts.
    - `facet` string — Name of the facet. This is also the string that needs to be used in the filtering expression.
    - `facetCounts` FacetCount[] — List of counts for the facet (if categorical).
      - `value` string — Value of the facet stringified. Timestamps will be formatted using RFC3339.
      - `count` integer — Count of records with the value.
    - `facetType` string — The type of the facet. Options include "string", "int", "float", "bool", "enum", "timestamp", "user" and are useful to show the right sort of UI controls when building a AIP-160 style filtering string.
    - `minValue` string — Min value of the facet stringified based on type. This is only populated for facets that have a clear ordering, for types like enum it will be left empty. Timestamps will be formatted using RFC3339.
    - `maxValue` string — Max value of the facet stringified based on type. Will be populated and formatted the same as min_value.
    - `totalCount` string, int64 — Total number of records that contain this facet with ANY value.

---

[API](https://skmtc.net/virustotal/apis/threat-landscape.md) · [All operations](https://skmtc.net/virustotal/apis/threat-landscape/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/virustotal/threat-landscape/revisions/d61b85e6a6b3/schema)