---
updatedAt: 2025-11-11T01:49:58.000Z
---

Fetch the complete documentation index at: https://docs.formant.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Using the Cloud SDK

## Querying using the Cloud SDK

The primary programmatic way data scientists query for telemetry data is via the Cloud SDK, a lightweight Python module which can interact with the query API. It can be installed with `pip3 install formant`.

[See the section on querying for telemetry data from our full guide to the Cloud SDK](https://docs.formant.io/reference/querying-telemetry-data)

## Example script

Here's an example of how telemetry data can be queried with the Cloud SDK. Check out the full guide for more examples and explanation.

```python
from formant.sdk.cloud.v1 import Client as FormantClient


if __name__ == "__main__":
    # to authenticate set FORMANT_EMAIL and FORMANT_PASSWORD
    # environment variables for an existing service account
    fclient = FormantClient()

    result = fclient.query(
        {
            "start": "2021-02-22T23:59:00.000Z",
            "end": "2021-02-23T00:00:00.000Z",
            "deviceIds": ["2c18bc8b-c5e4-4ea0-8886-a8363d185597"],
            "names": ["$.host.network", "$.host.cpu"],
        }
    )
    print(result)
```