Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact Us
English (US)
US English (US)
ES Spanish
IT Italian
  • Home
  • Using the Platform
  • Data Export

Export Jobs: Catalog Interface

Written by Omri Landman

Updated at March 1st, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Using the Platform
    Getting Started Administration Energy Applications Triggers and Notification Center Data Export Data Import Reports
  • Hardware & Deployment
    Frequently Asked Questions (FAQ) Hardware Datasheets and Deployment Guides Software Deployment Guide Troubleshooting Flow Charts
  • Interactive Demos
  • Legal
+ More

Table of Contents

Meta Data - Catalog CSV Catalog Example JSON Catalog Example (Version 1.0) JSON Catalog Example (Version 1.1)

Once you have set up your export jobs in the platform (see Export Jobs: Setup), each job invocation will create a data file/stream. The service supports Four types of data: Catalog, Measurements, Pulse Meter Measurements, and Pan42 Measurements. This guide will discuss what to expect in the Catalog export job type.

Meta Data - Catalog

The Catalog interface describes the structure of the monitored account. An account can have multiple sites, where each site can have multiple zones, multiple zones can have multiple panels and panels can have multiple devices. This data refers to the physical location and division of devices over the account's assets. In addition, the electrical hierarchy of the devices is also represented in the Catalog.

Name Description
id A unique identifier of an entity in the software. The ID can be either a site or device ID. In V1.1 the ID could be an account also
name The entity’s name as assigned at installation time.
type The entity type; this can be either “Site” or “Device”. 
parent_id The current entity parent ID in the hierarchy tree. 
panel_id A unique identifier of the physical panel in the software, in which the device is located. Note that a single zone can contain multiple panels. 
panel_name The panel’s name as assigned at installation time. For example, "Panel 54-A". 
zone_id A unique identifier of the physical zone in the software in which the device is located. Note that a single site can contain multiple zones. 
zone_name The zone’s name as assigned at installation time. For example, "Accounting department". 
site_id A unique identifier of the physical site in the software, in which the device is located. 
site_name The site’s name as assigned at installation time. For example, “New York site". 
device_category The type of device according to its group main functionality. 
device_type The type of device according to its main functionality. 
electrical_type The device number of phases and deployed sensors. 
description The entity’s description as assigned at installation time. 

CSV Catalog Example

Below are examples of the two versions available for the Catalog export job option:

  • V1.0: Including data of sites and devices under the a specific site.
  • V1.1: Including data of account level, sites and devices under a specific site.

CSV Catalogue Example v1.0.csv

CSV Catalogue Example v1.1.csv

JSON Catalog Example (Version 1.0)

{
 "sites": [{
  "id": 11,
  "name": "Site 1",
  "type": "Site",
  "devices": [{
   "id": 1,
   "name": "Main Device",
   "type": "Device",
   "parent_id": 11,
   "panel_id": 1,
   "panel_name": "Main Panel",
   "zone_id": 1,
   "zone_name": "Zone 1",
   "site_id": 11,
   "site_name": "Site 1",
   "device_category": "Mains",
   "device_type": "Main",
   "electrical_type": "3 phases / 3 sensors",
   “description”: "Main Panel Description",
   "devices": [{
    "id": 2,
    "name": "AC Device",
    "type": "Device",
    "parent_id": 1,
    "panel_id": 1,
    "panel_name": "Main Panel",
    "zone_id": 1,
    "zone_name": "Zone 1",
    "site_id": 11,
    "site_name": "Site 1",
    "device_category": "Heating and Cooling",
    "device_type": "AC",
    "electrical_type": "Single-Phase / 1 sensor",
    “description”: "AC Device Description"
   },{
    "id": 3,
    "name": "Dryer",
    "type": "Device",
    "parent_id": 1,
    "panel_id": 2,
    "panel_name": "2nd Floor Panel",
    "zone_id": 1,
    "zone_name": "Zone 1",
    "site_id": 11,
    "site_name": "Site 1",
    "device_category": "Home Appliances",
    "device_type": "Dryer",
    "electrical_type": "Single-Phase / 1 sensor",
    “description”: " Dryer Description"
   }]
  }]
 }]
}

JSON Catalog Example (Version 1.1)

/* Enter{
  "account": [
    {
      "id": 1291,
      "name": "IL Central District",
      "type": "Account",
      "sites": [
        {
          "id": 191,
          "name": " Residence",
          "type": "Site",
          "parent_id": 1291,
          "devices": [
            {
              "id": 1657,
              "name": "Solar System",
              "type": "Device",
              "parent_id": 191,
              "panel_id": 194,
              "panel_name": "Main Panel",
              "zone_id": 193,
              "zone_name": "House",
              "site_id": 191,
              "site_name": " Residence",
              "device_category": "Generation",
              "device_type": "PV / Solar",
              "electrical_type": "Single-Phase / 1 sensor",
              "description": "Solar system"
            },
            {"id": 49322,
              "name": "Main Meter",
              "type": "Device",
              "parent_id": 191,
              "panel_id": 194,
              "panel_name": "Main Panel",
              "zone_id": 193,
              "zone_name": "House",
              "site_id": 191,
              "site_name": " Residence",
              "device_category": "Mains",
              "device_type": "Main",
              "electrical_type": "3 phases / 3 sensors",
              "description": "Main Meter",
    }]
   }]
  }]
 your code */
catalog interface export jobs

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • What is the difference between Managed Load and Real-Time Consumption on the Site Dashboard?
  • What languages can I view on the platform?
  • What port and port range does the FTP servers for the Transfer Family operate over?
  • Export Jobs: Measurements Interface
Expand