Query meter readings

Through this API you can consult the list of readings inserted to a Fracttal meter.

In this web service you can filter to obtain all the meter readings associated to a particular asset or to obtain all the readings of a specific meter.

The parameter to query the meter readings associated to an asset is:

Code: Code of the asset to which the meter is associated.

The parameters to query the readings of a particular meter are:

Code: Code of the asset to which the meter is associated - Serial: Serial of the meter.

This API allows you to filter by the date of the reading to get the meter readings you need.

Input parameters

Parameter Type Required Description

code *Text Optional Code of the asset associated with the meter.

type_date

*Text

Optional

Type of date to make the query. It can be:

Value	Description
date	Date created
date_reading	Date read

serial *Text Optional Serial number of the meter to be consulted.

since Text Optional Initial date, applies to the reading date. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′.

until Text Optional End date, applies to the reading date. Formato: ‘YYYY-MM-DDTHH:MM:SS-UTC’ Ejemplo:’2016-07-12T20:00:00-03′.

code_location Text Optional Location code.

start Integer Optional Field used to make the pagination of records. It is the number at which the pagination starts. By default it is 0

limit Integer Optional Number of records (items) you want the API to return. Default is 100 (cannot be higher than this value).

Output parameters

Parameter Type Description

date_reading Text Date of reading

date Text Date of insertion in Fracttal

data

json

Reading information:

	Parameter	Description
date	Date of the reading
value	Value
accumulated_value	Accumulated value	Accumulated value

units_description Text Description Meter unit

units_code Text Unit code

trigger_run Boolean True when a task is triggered, false otherwise

source Text Source for reading: API, WORK_ORDER, MANUAL

Example:

Request: (GET) https://app.fracttal.com/api/meters_reading_list/?code=EQM027&serial=12345656

{
  "success": true,
  "message": "200",
  "data": [
   {
    "success": true,
    "message": "200",
    "data": [
        {
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:07:13+00:00",
            "date": "2019-08-21T14:07:13.932837+00:00",
            "data": {
                "date": "2019-08-21T14:07:13+00:00",
                "value": -8.701,
                "accumulated_value": -8.701
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "MANUAL"
           
        },
        {
           
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:06:03+00:00"
            "date": "2019-08-21T14:06:03.714035+00:00",
            "data": {
                "date": "2019-08-21T14:06:03+00:00",
                "value": -8.737,
                "accumulated_value": -8.737
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "API",
           
           
        },
        {
            "id_meter": 1157,
            "date_reading": "2019-08-21T14:05:12+00:00"
            "date": "2019-08-21T14:05:14.151536+00:00",
            "data": {
                "date": "2019-08-21T14:05:12+00:00",
                "value": -8.769,
                "accumulated_value": -8.769
            },
            "units_description": "TEMPERATURA",
            "units_code": "C",
            "trigger_run": false,
            "source": "WORK_ORDER"
        }
  ],
  "total": 3
}

Test It