Trumeter Cloud API – User Guide

Secure, read-only access to your device metadata and telemetry. Integrate Trumeter data into your applications, dashboards, or BI tools.

Get Started Open Swagger

Endpoints included

  • • GET /api/deviceList (Device List)
  • • GET /api/currentData (Current Data)
  • • GET /api/historicalData (Historical Data)

Auth: X-Authorization: Bearer <token>

1) Introduction

The Trumeter Public API provides secure, read-only access to your device metadata and telemetry so you can automate reporting, integrate with BI tools, and build custom monitoring solutions.

  • Automate device data retrieval
  • Integrate current & historic telemetry into external tools
  • Build custom dashboards & alerts

2) Getting Started

Step 1 – Sign up (if needed)
  1. Visit cloud.trumeter.com.
  2. Create an account using your company email.
  3. Verify your email and sign in.
Sign up page screenshot
Figure 1: Sign-up page
Step 2 – Generate an API Token
  1. On the Dashboard, click the Key icon.
  2. In the API Token widget, click Generate Token.
Generate token widget screenshot
Figure 2: Generate token widget
Step 3 – Manage Your Token

The widget shows:

  • Token with Copy button
  • Expiry date
  • Enable/Disable switch
  • Regenerate token
Manage token widget screenshot
Figure 3: Manage token options
Step 4 – Copy Your Token

Click Copy. You’ll use this token in the X-Authorization header as a Bearer token.

Copy token screenshot
Figure 4: Copying the token

3) Using the API

Include your token in every request:

curl -X GET "https://api.trumeter.cloud/[endpoint]" \
  -H "X-Authorization: Bearer <your_token_here>"

DeviceList

curl -X GET "https://api.trumeter.cloud/api/deviceList" \
  -H "X-Authorization: Bearer <your_token_here>"

CurrentData

curl -X GET "https://api.trumeter.cloud/api/currentdata?device_serial_no=1234567890" \
  -H "X-Authorization: Bearer <your_token_here>"

HistoricData

curl -X GET "https://api.trumeter.cloud/api/historicalData?device_serial_no=1234567890&key=voltage&from=1761916693596&to=1761916706974" \
  -H "X-Authorization: Bearer <your_token_here>"

Important Responses headers include: X-RateLimit-Limit, X-RateLimit-Window, X-RateLimit-Remaining,API-Calls-Left,Content-Type.

4) Swagger Documentation

  1. Open the Swagger UI (documentation URL provided by Trumeter).
  2. Click the Authorize button.
  3. Paste your token (without the word Bearer—the UI will prepend it).
  4. Choose an endpoint → Try it out → Execute.
Swagger authorize screenshot
Figure 5: Authorizing with your token in Swagger

5) Additional Notes

  • API quotas and rate limits apply per customer account.
  • Use Epoch format (milliseconds) for timestamps.
  • Errors follow a standard schema (see Swagger: 400, 401, 404, 429, 500).

6) Support

For assistance: