Mango REST API Reference
Version: 5.6.3
The Mango REST API provides full programmatic access to the platform. Use this reference to explore all available endpoints, understand request and response schemas, and test calls directly from the browser using the Try It Out panel.
Base URL
All API calls use the path /rest/latest/ on your Mango server. For example:
http://your-mango-server:8080/rest/latest/
Authentication
Mango supports two authentication schemes:
| Scheme | Type | How to use |
|---|---|---|
| Basic Auth | HTTP Basic | Send your Mango username and password with each request |
| Bearer Auth | HTTP Bearer (JWT) | Obtain a JWT token from the Authentication Tokens endpoints, then send it as Authorization: Bearer <token> |
Try It Out
Each endpoint page includes an interactive Try It Out panel on the right side. To make a live API call:
- Set your server URL — click the server URL field at the top of the panel and replace it with your Mango instance URL (e.g.,
http://localhost:8080) - Enter credentials — provide either:
- Username / Password (Basic Auth), or
- Bearer Token (JWT — obtain one from the Authentication Tokens endpoints)
- Fill in the request fields — path parameters, query parameters, and request body as required
- Click Send API Request — the response (or error) will appear below
The Try It Out panel sends real requests to your Mango instance. It will not work without a running Mango server.
Sidebar Categories
Endpoints are organized into 11 categories:
| Category | What's inside |
|---|---|
| Authentication | Login, logout, auth tokens, password reset |
| Data | Data points, data sources, point values, tags |
| Events | Events, event types, detectors, handlers, maintenance events |
| Publishing | Publishers and published points |
| Users & Permissions | Users, roles, access control |
| System | Server info, settings, modules, metrics, certificates |
| Storage | JSON store, file store, NoSQL, import/export |
| Scripting | Scripts, global scripts, script data sources |
| Utilities | Mailing lists, schedules, watch lists, translations |
| Tools | Protocol integrations: Modbus, BACnet, SNMP, HTTP, Haystack, and more |
| Enterprise | Paid modules: Excel Reports, Cloud Connect |
Contact
Radix IoT Support
Related Pages
- Authentication — How to authenticate API requests
- RQL Queries — Filter, sort, and paginate results
- API Examples — Practical curl and JavaScript examples