Skip to main content
Use where to filter any search endpoint. Its shape follows a recursive condition-group model: each group combines child conditions with and or or, and every child can be another group.
This evaluates as:
q, id, and the entity implied by a typed endpoint compose with where as an outer AND.

Groups and conditions

A group has two fields: A leaf condition has field, operator, and usually value. exists and not_exists omit value. Requests may contain at most 20 leaf conditions and may nest groups up to eight levels deep.

Operators

Fields

The runtime and OpenAPI schema share this field list. “Commonly populated for” describes the normalized records that usually carry a value; it is not a separate syntax per endpoint. Entity values are vulnerability, advisory, software, weakness, and attack-pattern. Use canonical identifiers such as CVE-2021-44228, CWE-79, and pkg:npm/lodash.

Cross-entity example