> ## 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.

# Discovering Variables, Entities, and Supported Options

> List and inspect the variables and metered entities your token can access, and discover supported resolutions, units, and standardizations before querying.

<Warning>
  This page previously described cached SQL query results and a generic dataset catalog. That's not the real design — there's no query caching and no arbitrary datasets. Discovery is scoped to variables and metered entities.
</Warning>

All paths below are relative to the base URL `https://api.communityhub.cloud/dh/public/v1`. A token is scoped to the **user**, not to a single organization — these endpoints return whatever the requesting user's account has permission to see, which may span multiple organizations.

<Warning>
  **Open — not fully decided.** Variables are queried and filtered by **metered entity**, not by organization; there's no `orgId` filter. The current direction — not yet finalized — is that `GET /variables` returns a hierarchy reflecting the requesting user's full access: **organizations → metered entities → variables**, rather than a flat list. The exact query-parameter design for filtering (e.g. by a specific metered entity) hasn't been settled. Treat the endpoint shapes below as directional, not confirmed.
</Warning>

## List organizations

```text theme={null}
GET /organizations
```

Returns the organizations accessible to the requesting user's token, in a lightweight `?mode=short` form or the default full form. See [Organizations](/api-reference/query/organizations) for both response shapes and open questions.

## List variable filter options

```text theme={null}
GET /variable/get-variable-filter-data
```

Returns the filter facets (organization, resource, variable type, entity type, entity, status, data reception) available for building a variable-listing filter UI, scoped by `orgIds`. See [Filter Options](/api-reference/query/variable-filters) for the full response shape and open questions, or [try the whole filter → list-variables flow live](/api-reference/query/variables-playground).

## List/search variables

```text theme={null}
POST /variable/list
```

Search and paginate variables using the same filters as [`GET /variable/get-variable-filter-data`](/api-reference/query/variable-filters), plus a `showHiddenVariables` toggle. See [Variable List](/api-reference/query/variable-list) for the full request/response shape, and its [Connected Variables](/api-reference/query/variable-list#connected-variables) section for fetching every variable tied to a specific monitored entity.

## List variables

```text theme={null}
GET /variables
```

Supports filters: `tag`, `resource`, `status`. Expected to also support filtering by metered entity once that design is finalized.

## Get a single variable's metadata

```text theme={null}
GET /variables/{dataHubId}
```

## List monitored entity filter options

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

Returns the filter facets (organization, metered entity type, tag) available for building a monitored-entity listing filter UI, scoped by `orgIds`. See [Filter For List](/api-reference/query/monitored-entity-filters) for the full response shape, including the org-scoped `tags` facet, and open questions — including whether `monitored-entity` here and `metered-entities` below refer to the same resource.

## List/search monitored entities

```text theme={null}
POST /monitored-entity
```

Search and paginate monitored entities using the same filters as `GET /monitored-entity/get-filters`, plus a `showHiddenMeteredEntities` toggle. See [Monitored Entity List](/api-reference/query/monitored-entity-list) for the full request/response shape.

## Get a single monitored entity

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

See [Get Monitored Entity](/api-reference/query/monitored-entity) for the open question about this path's naming versus `metered-entities` below, and [Connected Variables](/api-reference/query/monitored-entity-connected-variables) for fetching every variable tied to one of these entities.

## List data source type filter options

```text theme={null}
GET /data-source/type/filters
```

Returns the filter facets (currently just `organizations`) available for the data source type listing. See [Get Filters](/api-reference/query/data-source-type-filters) for the full response shape and open questions.

## List/search data source types

```text theme={null}
POST /data-source/type
```

Search and paginate the data source types (integrations) available in Data Hub, filtered by organization. See [Type Listing](/api-reference/query/data-source-type-list) for the request shape and the list of currently supported integration types.

## List data source instance filter options

```text theme={null}
GET /data-source/instance-filters
```

Returns the filter facets (`organizations`, `errorType`, `status`) available for filtering the data source instance listing. No instance-listing endpoint itself has been documented yet. See [Instance Filters](/api-reference/query/data-source-instance-filters) for the full response shape and open questions.

## List metered entities

```text theme={null}
GET /metered-entities
```

Returns the metered entities accessible to the requesting user's token — potentially across more than one organization.

## Get a single metered entity's metadata

```text theme={null}
GET /metered-entities/{id}
```

## Get data source metadata

```text theme={null}
GET /data-sources/{id}
```

## Independent discovery

```text theme={null}
GET /resolutions
GET /units
GET /standardizations
```

These list the resolutions, units, and standardizations Data Hub supports — useful for building a UI or validating parameters before calling [Get Variable Data](/api-reference/query/run-query).

<Note>
  This page is a stub for exact response payload shapes for each endpoint — those haven't been finalized in the source spec yet, on top of the open items flagged above.
</Note>