GET /v1/variables/{dataHubId}/data — Retrieve Variable Data

This page previously documented a POST /query SQL endpoint. That’s not the real design — retrieval is a plain GET against a specific variable, not an arbitrary query language.

Endpoint

GET /v1/variables/{dataHubId}/data

The organization is not part of the path — dataHubId alone identifies the variable, and access is governed by the requesting user’s permissions rather than an org scoped to the token. See Authentication.

Parameters

Parameter	Description
`start`, `end`	ISO 8601 timestamps bounding the requested range. Maximum range per request: 1 year.
`resolution`	One of: raw, minute, 15-minute, hourly, daily, weekly, monthly, yearly.
`units`	Optional unit conversion, limited to conversions Data Hub explicitly supports.
`standardization`	Optional standardization (e.g. per square foot, per occupant), limited to supported standardizations.
`format`	`json` (only format at launch).

Worked example

Request: hourly outdoor air temperature from a specific weather station, for a full semester, as JSON.

curl "https://api.communityhub.cloud/dh/public/v1/variables/wx-002-temp-outdoor/data?start=2025-08-25T00:00:00Z&end=2025-12-19T00:00:00Z&resolution=hourly&format=json" \
  -H "Authorization: Bearer <token>"

Example response (abbreviated):

{
  "data_hub_id": "wx-002-temp-outdoor",
  "units": "degC",
  "resolution": "hourly",
  "data": [
    { "timestamp": "2025-08-25T00:00:00Z", "value": 21.4 },
    { "timestamp": "2025-08-25T01:00:00Z", "value": 20.9 }
  ]
}

This page is a stub for the exact error response shape — that hasn’t been finalized in the source spec yet.

See Rate Limits for the request budget (60 req/min per token, 1-year max range).

Filter OptionsFetch the filter facets (organizations, resource types, variable types, entity types, entities, status, data reception) used to build a variable-listing filter UI, scoped to one or more organizations.

⌘I

Overview

Data Ingestion (Not Available)

Retrieving Data

Webhooks (Not Available)

Sample Code (No SDKs)

GET /v1/variables/{dataHubId}/data — Retrieve Variable Data

Endpoint

Parameters

Worked example

​Endpoint

​Parameters

​Worked example

Endpoint

Parameters

Worked example