Get a Single Sensor Reading — GET /api/sensor-data/{id}

Returns the full detail of a single sensor reading by its database ID. The response includes eager-loaded device name and sensor type details (name and measurement unit).

Endpoint

GET /api/sensor-data/{id} Auth: None required. This is a public apiResource route.

Path Parameters

integer

required

The numeric primary key of the sensor reading to retrieve. Must correspond to an existing record in the sensor_data table.

Example Request

curl -X GET http://localhost/api/sensor-data/42

Responses

200 OK

The reading was found. Returns the full record with eager-loaded device and sensor_type relationships.

{
  "status": "success",
  "data": {
    "id": 42,
    "device_id": 3,
    "sensor_type_id": 2,
    "reading_value": 73.5,
    "recorded_at": "2024-01-15T10:30:00.000000Z",
    "device": {"id": 3, "name": "Invernadero A"},
    "sensor_type": {"id": 2, "name": "Humedad del suelo", "unit": "%"}
  }
}

status

string

Always "success" on a 200 response.

data

object

The full sensor reading record.

Show data fields

data.id

integer

Primary key of the sensor reading record.

data.device_id

integer

Foreign key referencing the device that submitted the reading.

data.sensor_type_id

integer

Foreign key referencing the sensor_types record (integer ID).

data.reading_value

number

The stored sensor measurement, cast as a float. Stored internally as DECIMAL(10,4).

data.recorded_at

string

ISO 8601 UTC timestamp of when the reading was recorded.

data.device

object

Eager-loaded device relationship. Contains only id and name fields (e.g. {"id": 3, "name": "Invernadero A"}).

data.sensor_type

object

Eager-loaded sensor type relationship. Contains id, name, and unit fields (e.g. {"id": 2, "name": "Humedad del suelo", "unit": "%"}).

404 Not Found

No sensor reading with the given id exists in the database.

{"status": "error", "message": "Lectura no encontrada"}

Authentication

Devices

Sensor Data

Get a Single Sensor Reading — GET /api/sensor-data/{id}

Endpoint

Path Parameters

Example Request

Responses

200 OK

404 Not Found

Build docs developers (and LLMs) love

Authentication

Devices

Sensor Data

Documentation Index

​Endpoint

​Path Parameters

​Example Request

​Responses

​200 OK

​404 Not Found

Build docs developers (and LLMs) love

Endpoint

Path Parameters

Example Request

Responses

200 OK

404 Not Found