Skip to main content

Getting Started

A step-by-step walkthrough from creating your ZENTRA Cloud account to making your first authenticated v5 API request and pulling device data.

Getting Started

This guide takes you from a new account to your first successful v5 API request. If you already have an account and a token, skip to Make your first request below.

1. Create an account and set up an organization

Devices belong to organizations, and API access is granted through organization membership. Create your account and organization first.

Create an account and set up an organization

2. Add a data logger

Add at least one data logger so there are devices to discover and data to pull.

Add a data logger

3. Get your API token

Your API key authenticates every request. It's per-user and found on your account's Integrations page.

Get your API token

See API Token for full details on copying, regenerating, and securing it.

4. Make your first request

With your token in hand, list the devices your key can access. This is the best first call because it needs no prior knowledge — it returns the device_id values you'll use everywhere else.

curl "https://api.zentracloud.io/v5/devices" \ -H "X-API-Key: YOUR_API_KEY"

A 200 OK returns a devices array and a pagination object. Copy a device_id from the response — you'll need it for the next step.

5. Pull some data

Use a device_id from the previous step to retrieve that device's readings:

curl "https://api.zentracloud.io/v5/devices/z6-00930/data?direction=descending&units=metric" \
  -H "X-API-Key: YOUR_API_KEY"

Next steps

  • List Devices — filtering by organization, paging through large sets, and requesting each device's measurement range.
  • Get Device Readings — date/timestamp windows, ordering, units, and pagination.
  • Rate Limiting and Errors — what to expect and how to handle it as you scale up.
  • v5 API Overview — the concepts shared across all endpoints.

How did we do?

v5 API Overview

API Token

Contact