Get meter by meterId

Time Status User Agent
Make a request to see history.

URL Expired

The URL for this request expired after 30 days.

Meters API V1 Deprecation

The Meters API v1 endpoints are being deprecated. Please use the new v2 endpoints outlined in this Meters API v2 developer guide. For a summary of field name and location changes from V1 to V2, see this changelog post.

API Schema

Meter Details

Field Name Type Required Description
account_id uuid required
meter_id uuid required The id of this meter. Takes the form of a UUID.
partner_reference string required The Reference to be used for the meter
connection_reference_ids array of strings required Set of connection reference IDs, which are the refIDs supplied during completed Leap Connect authorizations. A meter may have multiple connection reference IDs if multiple people authorized the same meter or a single person authorized a meter multiple times with different reference IDs each time. This field contains all associated reference IDs ever supplied during successful authorizations of this meter. Also returns reference IDs for authorizations that are no longer active. The very first connection reference ID will be used as the partner_reference for the meter. Subsequent reference IDs for completed authorizations on this meter will be shown in this array but will not update the partner_reference field. This list may be empty, as not all authorizations come in with a reference ID.
transmission_region string enum, required CAISO, ERCOT, NYISO, ISONE, PJM
utility string The utility the meter is connected to
load_serving_entity string Organization responsible for procuring load on behalf of this meter in the wholesale market.
load_zone string The regional aggregation wherein meters can be assigned to a Resource.
participation array of objects required The programs this meter is participating in.
bill_service_account_number string
customer_name string The name of the owner of this meter, given by the utility.
service_address_full string The full address in one line for quick identification/comparison.
service_address object required
street_1 string required Service address street
street_2 string Additional street information (optional)
postal_code string required Postal code
city string required City
state_or_province string required State or province
country string required Country
enrollment object required Enrollment response
active_periods object required Active periods object
status_reasons array of objects required Status reasons object
partner_preferred_action string enum, required Participate, Idle, Disenroll
action_required boolean required
tariff string Tariff code indicating the rate of the service agreement between the utility and end-customer.
created_at date-time required The timestamp on which this meter record was first created.
updated_at date-time required The timestamp on which this meter record was last updated.
meter_type string required The type of the meter.
tags array of strings required The tags associated with this meter.

Responses

Example Curl Request

curl --request GET \
     --url https://api.staging.leap.energy/v1.1/account//meter/ \
     --header 'accept: application/json'

Example Response

{
  "participation": [
    {
      "market_group_name": "GRP1_NAME",
      "program_name": "DRAM",
      "market_group_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "trade_date": "2000-01-23T04:56:07.000+00:00"
    },
    {
      "market_group_name": "GRP1_NAME",
      "program_name": "DRAM",
      "market_group_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "trade_date": "2000-01-23T04:56:07.000+00:00"
    }
  ],
  "bill_service_account_number": "1234567890",
  "load_serving_entity": "load_serving_entity",
  "utility": "SCE",
  "created_at": "2000-01-23T04:56:07.000+00:00",
  "meter_type": "meter_type",
  "service_address": {
    "state_or_province": "California",
    "country": "US",
    "street_1": "914nd Street",
    "city": "Seah",
    "street_2": "street_2",
    "postal_code": "42908"
  },
  "transmission_region": "CAISO",
  "bill_customer_agreement_number": "1234567890",
  "enrollment": {
    "partner_preferred_action": "Participate",
    "eligible_from": "2000-01-23T04:56:07.000+00:00",
    "eligible_to": "2000-01-23T04:56:07.000+00:00",
    "partner_indicated_disenrollment": {
      "reasons": [
        { "code": "code", "comment": "comment" },
        { "code": "code", "comment": "comment" }
      ],
      "from": "2000-01-23T04:56:07.000+00:00"
    },
    "action_required": true,
    "status_reasons": [
      { "code": "code", "comment": "comment" },
      { "code": "code", "comment": "comment" }
    ],
    "status": "Active",
    "active_periods": {
      "next": {
        "from": "2000-01-23T04:56:07.000+00:00",
        "to": "2000-01-23T04:56:07.000+00:00"
      },
      "current": {
        "from": "2000-01-23T04:56:07.000+00:00",
        "to": "2000-01-23T04:56:07.000+00:00"
      },
      "previous": {
        "from": "2000-01-23T04:56:07.000+00:00",
        "to": "2000-01-23T04:56:07.000+00:00"
      }
    },
    "partner_indicated_idle_period": {
      "reasons": [
        { "code": "code", "comment": "comment" },
        { "code": "code", "comment": "comment" }
      ],
      "from": "2000-01-23T04:56:07.000+00:00",
      "to": "2000-01-23T04:56:07.000+00:00"
    }
  },
  "tags": ["tag1", "tag2"],
  "load_zone": "load_zone",
  "service_address_full": "914nd Street, 42908 Seah, California, US",
  "updated_at": "2000-01-23T04:56:07.000+00:00",
  "partner_reference": "meter1",
  "service_point_number": "SAN-0250508399",
  "connection_reference_ids": ["connectionReferenceId1"],
  "tariff": "tariff",
  "customer_name": "customer_name",
  "meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
}