Filtering
System filters
Built-in filter keys that target non-attribute fields
Some properties are not modelled as attributes but are still useful to filter on. These are exposed as system filter keys, identified by a leading underscore.
| Key | Category | Description |
|---|---|---|
_updated_at | datetime | The entity's last-updated timestamp. |
_family | preset | The product family the entity belongs to. Values are family IDs. |
System filters use the same { operator, value } shape as attribute filters and follow the category's operator matrix.
Examples
Products updated in the last 7 days:
{ "_updated_at": [{ "operator": "IN_THE_LAST", "value": "7d" }] }Products in family 12 or 34:
{ "_family": [{ "operator": "IN", "value": ["12", "34"] }] }Products without a family:
{ "_family": [{ "operator": "EMPTY" }] }Products updated after a specific date:
{ "_updated_at": [{ "operator": "AFTER", "value": "2024-01-15T00:00:00Z" }] }