Query advanced meters

Through this API, you can query advanced information about meters created in Fracttal. It contains information related to the asset it's linked to and information about the last maintenance.

This API allows you to filter to get only the meters you need: by asset code and/or by meter serial.

  • To get meters that belong to a specific asset, you need to send the "code" parameter (asset code).
  • To get information about a specific meter, you need to send the "code" (asset code) and "serial" (meter serial) parameters.

Input Parameters

ParameterTypeRequiredDescription
codeTextOptionalCode of the asset that has the meter associated.
serialTextOptionalSerial of the meter you want to query.
startIntegerOptionalField used for record pagination. It's the number where pagination starts. Default is 0
limitIntegerOptionalNumber of records (items) you want the API to return. Default is 100 (Cannot exceed this value)

Output Parameters

Parameter

Type

Description

description

Text

Meter Description

serial

Text

Meter serial

is_counter

Text

Value that indicates if the meter is a counter type

counter_offset_value

Text

Accumulated Value

counter_value

Text

Current meter value

last_data

Text

Information of the last reading added to the meter: -"date": date, -"value": value, -"accumulated_value": accumulated value

monthly_average_data

Text

Monthly average value

units_description

Text

Description of the meter unit

units_code

Text

Code of the meter unit

items_description

Text

Description of the asset to which the meter belongs

items_parent_description

Text

Location to which the asset belongs

id_task

Number

Task ID

task_description

Text

Task description

id_task_trigger_type

Number

Trigger type ID. 1: Date, 2: When trigger, 3: Every trigger, 4: Event trigger.

monthly_average_auto

Boolean

Value indicating if the monthly average will be calculated by the system or manually entered by the user

last_value_trigger

Number

Reading value at last maintenance

last_date_maintenance

Date

Date of last maintenance triggered by reading

id_company

Number

Company ID

Example:

Request: (GET)https://app.fracttal.com/api/meters_advanced/ACT-001

{
    "success": true,
    "message": "200",
    "data": [
        {
            "id": 177136,
            "is_counter": true,
            "active": true,
            "description": "Nuevo Medidor Refrigerador",
            "serial": "0",
            "counter_value": 2405,
            "counter_offset_value": 0,
            "id_unit": 6,
            "units_code": "KM",
            "units_description": "KILOMETROS",
            "id_parent_meter": null,
            "parent_meter_description": " {}",
            "monthly_average_data": 1,
            "id_item": 20005233,
            "items_id_type_item": 2,
            "items_code": "SVPRACT13",
            "items_description": "SV REFRIGERADOR DE VACUNAS",
            "items_id_priority": null,
            "items_id_group": null,
            "items_id_group_2": null,
            "items_field_2": "SV SAMSUNG",
            "items_field_3": "SV C13 D",
            "items_field_4": "SV 001827",
            "items_parent_description": "// ",
            "id_task": 2466764,
            "tasks_description": "Mantenimiento cada 600km",
            "id_task_trigger_type": 3,
            "last_value_trigger": "1805",
            "last_date_maintenance": "2022-05-27T16:48:28.432111+00:00",
            "id_company": 1190
        }
    ],
    "total": 1
}
Language