Skip to main content
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.
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.
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.

​
List organizations

Returns the organizations accessible to the requesting user’s token, in a lightweight ?mode=short form or the default full form. See Organizations for both response shapes and open questions.

​
List variable filter options

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 for the full response shape and open questions, or try the whole filter → list-variables flow live.

​
List/search variables

Search and paginate variables using the same filters as GET /variable/get-variable-filter-data, plus a showHiddenVariables toggle. See Variable List for the full request/response shape, and its Connected Variables section for fetching every variable tied to a specific monitored entity.

​
List 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

​
List monitored entity filter options

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

Search and paginate monitored entities using the same filters as GET /monitored-entity/get-filters, plus a showHiddenMeteredEntities toggle. See Monitored Entity List for the full request/response shape.

​
Get a single monitored entity

See Get Monitored Entity for the open question about this path’s naming versus metered-entities below, and Connected Variables for fetching every variable tied to one of these entities.

​
List data source type filter options

Returns the filter facets (currently just organizations) available for the data source type listing. See Get Filters for the full response shape and open questions.

​
List/search data source types

Search and paginate the data source types (integrations) available in Data Hub, filtered by organization. See Type Listing for the request shape and the list of currently supported integration types.

​
List data source instance filter options

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 for the full response shape and open questions.

​
List 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

​
Get data source metadata

​
Independent discovery

These list the resolutions, units, and standardizations Data Hub supports — useful for building a UI or validating parameters before calling Get Variable Data.
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.