Skip to main content

REST API

The IOTMER REST API gives you programmatic access to everything in the platform — devices, MQTT config, billing, workspace management, authentication, and provisioning.

Base URL​

https://console.iotmer.com/api/

API reference​

The full specification and interactive explorer live in the API section of this site (generated from the OpenAPI description).

Request format​

All requests use JSON:

Content-Type: application/json
Accept: application/json

Pagination​

List endpoints are paginated:

GET /workspaces/{id}/devices?page=1&page_size=50

Response includes total, page, and page_size fields.

Error format​

All 4xx/5xx responses follow RFC 7807 Problem Details:

{
  "type": "https://console.iotmer.com/api/v1/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Device 01J... not found in workspace",
  "trace_id": "abc123"
}

The trace_id field is useful when reporting issues to IOTMER support.