> ## Documentation Index
> Fetch the complete documentation index at: https://docs.communityhub.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /monitored-entity/get-filters — Monitored Entity Filter Options

> Fetch the filter facets available for listing monitored entities, scoped to one or more organizations.

<Warning>
  This endpoint uses `monitored-entity` as its path segment, while the rest of this API and product documentation use **metered entity** (see [Core Concepts](/core-concepts) and [`GET /metered-entities`](/api-reference/query/saved-queries)). Whether these refer to the same resource under an inconsistent name, or something distinct, isn't confirmed — treat this page as provisional until that's resolved.
</Warning>

## Endpoint

```text theme={null}
GET /monitored-entity/get-filters
```

Returns the filter facets available for narrowing a monitored-entity listing, scoped to the organization(s) in `orgIds` — the same pattern used by [`GET /variable/get-variable-filter-data`](/api-reference/query/variable-filters) for variables.

## Parameters

| Parameter | Description                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `orgIds`  | One or more organization [`id`](/api-reference/query/organizations) values to scope the returned filters to. You can pass multiple organization ids to get filters scoped across all of them at once — see the multi-org example below. Exact encoding for multiple values (repeated `orgIds=` params vs. a comma-separated list) still isn't confirmed — see the equivalent open question on [Filter Options](/api-reference/query/variable-filters). |

## Example request

Single organization:

```bash theme={null}
curl "https://api.communityhub.cloud/dh/public/v1/monitored-entity/get-filters?orgIds=0c8a44f7" \
  -H "Authorization: Bearer <token>"
```

Multiple organizations — pass more than one id to get filters scoped across all of them:

```bash theme={null}
curl "https://api.communityhub.cloud/dh/public/v1/monitored-entity/get-filters?orgIds=0c8a44f7,3f8c1a02" \
  -H "Authorization: Bearer <token>"
```

<Note>
  Ids in the examples on this page follow the same convention as [Variable List](/api-reference/query/variable-list): ids identifying a specific real-world record (`organizations`, and the per-organization entries under `tags`) are shown as anonymized 8-character placeholders — reusing the same id already assigned to a given organization on the [Organizations](/api-reference/query/organizations) page wherever the name matches. Catalog-style ids already documented elsewhere (`buildingType`) are kept as the small integers already listed on [Filter Options](/api-reference/query/variable-filters).
</Note>

## Response shape

The response is an array of **facet groups**, following the same `{ id, label, children }` shape as [`GET /variable/get-variable-filter-data`](/api-reference/query/variable-filters) — but with a different set of facets, scoped to monitored entities rather than variables:

```json theme={null}
[
  {
    "id": "organizations",
    "label": "Organization",
    "children": [
      { "id": "3f8c1a02", "label": "City of Cleveland" },
      { "id": "9d2e77b4", "label": "City of Oberlin" },
      { "id": "6a1f0c9d", "label": "City of Oberlin (Private Organizations)" },
      { "id": "b57e2f81", "label": "Cleveland Foundation" },
      { "id": "e4913dc6", "label": "Great Lakes Science Center" },
      { "id": "0c8a44f7", "label": "Oberlin College" },
      { "id": "77b0e2ad", "label": "Oberlin Public Library" },
      { "id": "d3f6109b", "label": "Oberlin Schools" },
      { "id": "1a9e5c34", "label": "Sustainable Community Associates" },
      { "id": "f206b8e1", "label": "Toledo Public Schools" },
      { "id": "5e0d3a72", "label": "University of Washington Bothell" }
    ]
  },
  {
    "id": "buildingType",
    "label": "Metered Entity Type",
    "children": [
      { "id": 0, "label": "Building" },
      { "id": 1, "label": "Buoy" },
      { "id": 2, "label": "Central Plant" },
      { "id": 3, "label": "City" },
      { "id": 4, "label": "Environmental Sensor" },
      { "id": 5, "label": "Other" }
    ]
  },
  {
    "id": "tags",
    "label": "Tag",
    "children": [
      {
        "id": "0c8a44f7",
        "label": "Oberlin College",
        "children": [
          { "id": "95f52d63", "label": "Academic" },
          { "id": "60f10962", "label": "Administrative" },
          { "id": "5ee0f21d", "label": "Dining facility" },
          { "id": "86a061c0", "label": "Dormitory" },
          { "id": "c3491ac6", "label": "Exhibit hall" },
          { "id": "f48e5919", "label": "Fitness center" },
          { "id": "fbe9b891", "label": "Gym" },
          { "id": "54f167c2", "label": "Health club" },
          { "id": "f3c1835c", "label": "Hotel" },
          { "id": "cd25df34", "label": "Industrial plant" },
          { "id": "41abb1ad", "label": "Library" },
          { "id": "dcfd7688", "label": "Manufacturing" },
          { "id": "3f0d7f68", "label": "Office" },
          { "id": "3286d7e1", "label": "Performing arts" },
          { "id": "faef7611", "label": "Renewable" },
          { "id": "26a01191", "label": "Residence" }
        ]
      },
      {
        "id": "d3f6109b",
        "label": "Oberlin Schools",
        "children": [
          { "id": "6a25c4c2", "label": "Academic" },
          { "id": "63ab45f3", "label": "Administrative" },
          { "id": "2cd407d8", "label": "Dining facility" },
          { "id": "d532ac29", "label": "Dormitory" },
          { "id": "d297876c", "label": "Ecolympics 2025" },
          { "id": "586e8a44", "label": "Exhibit hall" },
          { "id": "362cc77b", "label": "Fitness center" },
          { "id": "aa33d198", "label": "Gym" },
          { "id": "ceb8907a", "label": "Health club" },
          { "id": "48d5b941", "label": "Hotel" },
          { "id": "d969c483", "label": "Industrial plant" },
          { "id": "efb9900f", "label": "Library" },
          { "id": "9df0e9a4", "label": "Manufacturing" },
          { "id": "bd48fa38", "label": "Office" },
          { "id": "97afb315", "label": "Performing arts" },
          { "id": "63c3c140", "label": "Renewable" },
          { "id": "48a2a3a0", "label": "Residence" }
        ]
      }
    ]
  }
]
```

### Facet groups returned

| Facet `id`      | Label               | Notes                                                                                            |
| --------------- | ------------------- | ------------------------------------------------------------------------------------------------ |
| `organizations` | Organization        | Same ids as [Organizations](/api-reference/query/organizations).                                 |
| `buildingType`  | Metered Entity Type | Same ids as the `buildingType` facet on [Filter Options](/api-reference/query/variable-filters). |
| `tags`          | Tag                 | Two levels deep — see below.                                                                     |

<Note>
  This endpoint's facet set is narrower than [`GET /variable/get-variable-filter-data`](/api-reference/query/variable-filters) (no `resourceType`, `pointType`, `status`, `dataReception`, or `building`) and adds one facet variables' filter data doesn't have at all: `tags`. That's expected, since the two endpoints filter different resources — but it means you can't assume the two responses share a facet set beyond `organizations` and `buildingType`.
</Note>

### The `tags` facet's nesting

`tags` is the only facet with two levels of `children`. The **top-level** children aren't tags themselves — each one is an organization, with its `id` matching that organization's id in the `organizations` facet above (for example, `0c8a44f7` = Oberlin College in both places). Each organization's own `children` array is that organization's actual list of tags, scoped to it — tag definitions (and their ids) belong to one organization and aren't shared across organizations, even when two organizations happen to use the same tag label (`Academic`, `Administrative`, and so on appear under both Oberlin College and Oberlin Schools above, with different ids each time).

<Warning>
  **Open — not fully decided:**

  * Exact encoding for multiple `orgIds` values (repeated param vs. comma-separated) — same open question as [Filter Options](/api-reference/query/variable-filters).
  * Whether `tags` is always nested exactly two levels deep, or whether deeper nesting is possible.
  * How (or whether) a selected `tags` value is meant to be sent back as a filter to a monitored-entity listing endpoint — no such listing endpoint has been documented yet.
</Warning>

See [Organizations](/api-reference/query/organizations) for valid `orgIds` values, [Monitored Entity List](/api-reference/query/monitored-entity-list) for searching entities with these facets as filters, [Get Monitored Entity](/api-reference/query/monitored-entity) for retrieving a single entity by id, and [Connected Variables](/api-reference/query/monitored-entity-connected-variables) for fetching the variables tied to a specific entity.