---
title: Query Time Series Data
slug: api/query-time-series-data
docTags: qTu4g35szZVJsjCIROvmT,fu_CgXzjBnePyWRJ1hjWo
createdAt: 2025-09-18T16:16:38.971Z
---

# Query time series data

This code queries data points from measurements and/or calculations ([my Swagger](https://historian.mycompany.com:18000/api/swagger/#/timeseries/queryTimeseries)).

<font color="#6366F1">**POST** </font>[https://historian.mycompany.com:18000/api/timeseries/query](https://historian.mycompany.com:18000/api/timeseries/query)

```python
def query_timeseries(
    start: str,
    end: Optional[str],
    limit: int = 0,
    measurement_uuids: Optional[List[str]] = None,
    measurements: Optional[List[Dict[str, str]]] = None,
    tags: Optional[Dict[str, str]] = None,
) -> Dict[str, Any]:
    assert measurement_uuids or measurements, "Provide MeasurementUUIDs or Measurements"
    payload: Dict[str, Any] = {"Start": start, "End": end, "Limit": limit}
    if measurement_uuids:
        payload["MeasurementUUIDs"] = measurement_uuids
    if measurements:
        payload["Measurements"] = measurements
    if tags is not None:
        payload["Tags"] = tags

    resp = session.post(f"{BASE_URL}/timeseries/query", json=payload, timeout=60)
    resp.raise_for_status()
    return resp.json()

# Example: by Database + Measurement
ts_query_result_1 = query_timeseries(
    start="2025-09-18T12:08:57.000Z",
    end="2025-09-18T13:08:57.000Z",
    limit=10,
    measurements=[{"Database": "MyDatabase", "Measurement": "MyMeasurement"}]
)
print(json.dumps(ts_query_result_1, indent=2))

# Example: by Measurement UUID
ts_query_result_2 = query_timeseries(
    start="2025-09-18T12:08:57.000Z",
    end="2025-09-18T13:08:57.000Z",
    limit=10,
    measurement_uuids=[ts_query_result_1["Series"][0]["MeasurementUUID"]]
)
print(json.dumps(ts_query_result_2, indent=2))
```

:::ExpandableHeading
### Successful response

Only 1 of the 2 printed results is included below since both JSONs are the same.

```json
{
  "Series": [
    {
      "Tags": {},
      "Measurement": "MyMeasurement",
      "MeasurementUUID": "5752db8c-5c32-11ef-9cc7-0242ac12000a",
      "Datatype": "number",
      "Database": "MyDatabase",
      "Fields": null,
      "DataPoints": [
        {
          "Value": 8.783881407302545,
          "Timestamp": 1758197337000
        },
        {
          "Value": 8.641683655337378,
          "Timestamp": 1758197338000
        },
        {
          "Value": 8.478773172859915,
          "Timestamp": 1758197339000
        },
        {
          "Value": 8.295414922228261,
          "Timestamp": 1758197340000
        },
        {
          "Value": 8.094342636556814,
          "Timestamp": 1758197341000
        },
        {
          "Value": 7.874790756291156,
          "Timestamp": 1758197342000
        },
        {
          "Value": 7.645188226432317,
          "Timestamp": 1758197343000
        },
        {
          "Value": 7.4040672744550236,
          "Timestamp": 1758197344000
        },
        {
          "Value": 7.153110423464768,
          "Timestamp": 1758197345000
        },
        {
          "Value": 6.8969023597570835,
          "Timestamp": 1758197346000
        }
      ]
    }
  ]
}

```
:::