# app.zeens.getEventFacets

> Published by [zeens.app](https://lexicon.garden/identity/did:plc:pwpuqwge6g7xrjmfbw73uycw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getEventFacets)
- [Documentation](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getEventFacets/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getEventFacets/examples)

## Definitions

### `app.zeens.getEventFacets`

**Type**: `query`

Category and mode counts for the events filter strip, aggregated in Postgres over the whole catalog (not tallied from a page of results). Lets the client offer only filters that will actually return something. Scoped by the same time window as getEvents, so an Upcoming strip counts upcoming events.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `filter` | `string` | No | Time window to count within. Must match the window the feed is showing, or the strip would offer a filter that returns nothing on this tab. |

#### Output

**Encoding**: `application/json`

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Category and mode counts for the events filter strip, aggregated in Postgres over the whole catalog (not tallied from a page of results). Lets the client offer only filters that will actually return something. Scoped by the same time window as getEvents, so an Upcoming strip counts upcoming events.",
      "output": {
        "encoding": "application/json"
      },
      "parameters": {
        "properties": {
          "filter": {
            "default": "upcoming",
            "description": "Time window to count within. Must match the window the feed is showing, or the strip would offer a filter that returns nothing on this tab.",
            "knownValues": [
              "upcoming",
              "past",
              "all"
            ],
            "type": "string"
          }
        },
        "type": "params"
      },
      "target_collection": "app.zeens.event",
      "type": "query"
    }
  },
  "id": "app.zeens.getEventFacets",
  "lexicon": 1
}
```