Mithra Public API
API Docs
API Docs
  1. API Docs
  • Mithra Public API
  • Realtime (SSE)
    • SSE Event Schema
    • Connect (SSE)
      GET
    • Subscribe (SSE)
      POST
  • List Sensors
    GET
  • List Locations
    GET
  • Sensor Readings
    GET
  1. API Docs

Sensor Readings

GET
https://api.mithra.network/public/v1/sensor/{sensor_id}/readings
Get the details of a sensor, including current readings. To fetch more data, use the last record's moment unix timestamp and include it in the next call as query param after_timestamp to fetch the next page of records. If you are persisting records in your own application, you can obviously stop fetching for more records when the last record's moment unix timestamp exceeds the record(s) you already have.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Query Params

Responses

🟢200Success
application/json
Body

🟠401Auth exception
🟠400Unknown exception
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.mithra.network/public/v1/sensor//readings?after_timestamp=1751883202' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
  "readings": [
    {
      "errors": [
        "Some error",
        "Another error"
      ],
      "measurements": [
        {
          "label": "Water level",
          "measured": 29.7,
          "state": null,
          "threshold": 26,
          "title": "85% tot vol"
        },
        {
          "label": "Water level (raw)",
          "measured": 29.7,
          "state": true,
          "threshold": 26,
          "title": null
        }
      ],
      "moment": 1751877546,
      "moment_string": "2025-07-07 08:39:06.160Z"
    }
  ]
}
Previous
List Locations
Built with