---
title: "Getting Started"
description: "A step-by-step walkthrough from creating your ZENTRA Cloud account to making your first authenticated v5 API request and pulling device data."
url: "https://docs.zentracloud.io/l/en/article/flaxog1o5b-getting-started-v5"
category: "v5.0"
updated_at: "2026-11-05T19:54:58Z"
language: "en"
---

# 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](/l/en/article/4rzmtkxn5i-create-account)

[→ Getting started Video 2: Create your account and organization](https://youtu.be/VEzYJX4EC7U)

#### 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](/l/en/article/mzu9p6hk88-add-data-logger)

[→ Getting started video 3: Add a data logger](https://youtu.be/Hig9VkwRBEo)

#### 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](https://app.zentracloud.io/profile/integrations)

See [API Token](/l/en/article/xot1qptzgz-api-token) for full details on copying, regenerating, and securing it.

[→ API Video 2: Get your API token](https://youtu.be/qFkdJiedA4I)

#### 4. Make your first request

[Make your first API request | ZENTRA Cloud](https://www.youtube.com/embed/d5OsYrkmSFY?feature=oembed)

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 the `device_id` of a device whose `can_read_data` is true — 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?window=24h&direction=descending&units=metric" \
  -H "X-API-Key: YOUR_API_KEY"
```

This returns the device's readings from the last 24 hours, newest first. Change window to 7d for the last week, or use start\_datetime and end\_datetime for a fixed range.

#### Next steps

- [List Devices](/l/en/article/7t31rdmwh4-list-devices) — filtering by organization, paging through large sets, and requesting each device's measurement range.
- [Get Device Data](/l/en/article/pep98lcz1h-get-device-readings) — date/timestamp windows, ordering, units, and pagination.
- [Rate Limiting](/l/en/article/f6wdg770d3-rate-limiting) and [Errors](/l/en/article/ajte070y7e-errors) — what to expect and how to handle it as you scale up.
- [v5 API Overview](/l/en/article/zjky832943-api-v5) — the concepts shared across all endpoints.
