Retrieving Equipment Status

To retrieve the last known status of your equipment, which includes the most recent sensor readings (like pressure or flow rate) as well as properties IrrigEasy deduces from raw data (e.g., whether a valve is open or closed), you have a few flexible options.

You can fetch this information by providing a list of specific equipment asset IDs in your request:

Request

POST https://api.telaqua.com/assets/status

{
    "assetIds": ["2c37ad05-379b-4823-a105-e1b5e5aab5e6", "a5fd205c-56a3-440f-bfa7-fefa88a1ff24"]
}

Response

[
    {
        "id": "a7d3ad8f-21fc-474f-8ca7-9d64bb5c6db0",
        "name": "Pompe A",
        "type": "PUMP",
        "assetId": "2c37ad05-379b-4823-a105-e1b5e5aab5e6",
        "state": {
            "desired": {},
            "reported": {
                "pressureLevel": {
                    "value": "Target",
                    "updatedAt": "2025-06-11T14:33:00Z"
                }
            }
        },
        "alerts": [],
        "latestSensorReadings": [
            {
                "name": "pressure",
                "unit": "bar",
                "value": 6.05,
                "receivedAt": "2025-06-12T06:55:00Z"
            }
        ],
        "latestSensorReadingsReceivedAt": "2025-06-12T06:55:00Z"
    },
    {
        "id": "0b61659a-5aaf-45a9-9748-f07f1d726a52",
        "name": "Valve A1",
        "type": "VALVE",
        "assetId": "a5fd205c-56a3-440f-bfa7-fefa88a1ff24",
        "state": {
            "desired": {},
            "reported": {
                "open": {
                    "value": true,
                    "updatedAt": "2025-06-12T06:55:00Z"
                },
                "pressureLevel": {
                    "value": "Target",
                    "updatedAt": "2025-06-12T06:55:00Z"
                }
            }
        },
        "alerts": [],
        "latestSensorReadings": [
            {
                "name": "pressure",
                "unit": "bar",
                "value": 2.09,
                "receivedAt": "2025-06-12T06:55:00Z"
            }
        ],
        "latestSensorReadingsReceivedAt": "2025-06-12T06:55:00Z"
    }
]

Alternatively, for broader queries, you can retrieve the status for all equipment of a certain equipment type or all equipment associated with a particular farm block. Choose the method that best suits your needs for efficient data retrieval.

Request

POST https://api.telaqua.com/assets/status

{
    "assetGroupIds": ["265c79cc-8b23-4e1b-bb23-582a6ad45d50"],
    "equipmentType": "PUMP"
}

Response

[
    {
        "id": "a7d3ad8f-21fc-474f-8ca7-9d64bb5c6db0",
        "name": "Pompe A",
        "type": "PUMP",
        "assetId": "2c37ad05-379b-4823-a105-e1b5e5aab5e6",
        "state": {
            "desired": {},
            "reported": {
                "pressureLevel": {
                    "value": "Target",
                    "updatedAt": "2025-06-11T14:33:00Z"
                }
            }
        },
        "alerts": [],
        "latestSensorReadings": [
            {
                "name": "pressure",
                "unit": "bar",
                "value": 5.9,
                "receivedAt": "2025-06-12T06:58:00Z"
            }
        ],
        "latestSensorReadingsReceivedAt": "2025-06-12T06:58:00Z"
    }
]