Data access, simplified

We collect, standardize, and share utility data seamlessly and securely in minutes.

UtilityAPI provides secure access to customer utility data through our easy-to-use products and solutions.

The problem

The solution

Details & Benefits

Direct integrations

UtilityAPI is the only data provider with utility partnerships to provide fast, reliable, trusted access direct integrations.

More free data

With direct integrations often comes data access that doesn’t cost a thing. Plus, not matter how you get the data, the first collection each month is on us.

Coast-to-coast coverage

We support utilities in most distributed solar markets, including retrieving interval data.

Fast turnaround

Our automated platform can collect data within seconds of customer authorization.

User-friendly dashboard

Our point-and-click dashboard is intuitive and easy for individuals and teams to use.

Seamless integration

Our platform can be easily incorporated into your existing solar analysis software and sales tools.

Get started now.

Types of data we provide:

Meter data

Effortlessly obtain access to a wide range of meter data points tailored to specific customer requirements. This capability allows for a more comprehensive understanding of customer energy consumption patterns, aiding in the development of customized energy management strategies and solutions.

Interval data

Easily access and export highly detailed, interval data records of customer energy consumption. This enables in-depth analysis and reporting, facilitating precise energy management and optimization strategies to enhance overall efficiency and cost savings.

Bill data

Unlock access to a comprehensive set of accounting and bill payment data, allowing for a thorough examination of customer payment details and their historical payment records. This will streamline financial processes, track payment trends, and enhance customer service by providing insight into billing and payment histories.

Usage data

Unlock access to detailed information on energy usage. This will provide a foundation for informed decision-making, such as optimizing energy consumption patterns, tracking trends, and identifying opportunities for cost savings and efficiency improvements.

Billing PDF

Access a complete copy of the customer’s utility bill in PDF format. This offers a detailed representation of the customer’s blue bill, allowing for a thorough examination of billing statements, which can be invaluable for audit, analysis, and customer support purposes.

Example API data

The api/v2/meters endpoints allow you to retrieve utility meter or similar service data. Click here to learn more about our Meter Data product.

// Meter with data
{
    "uid": "45678",
    "authorization_uid": "12345",
    "created": "2014-02-17T16:04:34.023534+00:00",
    "user_email": "sales@acmesolar.com",
    "user_uid": "3938",
    "is_archived": false,
    "is_activated": true,
    "is_expanded": true,
    "notes": [
        {
            "type": "access_valid",
            "ts": "2014-06-17T16:06:34.473724+00:00",
            "msg": "Logged in!"
        },
        {
            "type": "meter_full",
            "ts": "2014-06-17T16:06:34.473724+00:00",
            "msg": "Found all meter details."
        },
        {
            "type": "bills_full",
            "ts": "2014-06-17T16:06:34.473724+00:00",
            "msg": "Successfully collected bills."
        },
        {
            "type": "intervals_full",
            "ts": "2014-06-17T16:06:34.473724+00:00",
            "msg": "Successfully collected intervals."
        }
    ],
    "status": "updated",
    "status_message": "Data refreshed",
    "status_ts": "2014-06-17T16:06:34.473724+00:00",
    "ongoing_monitoring": {
        "frequency": "off",
        "prepay": null,
        "next_prepay": null,
        "next_refresh": null,
        "fixed_refresh_day": null
    },
    "utility": "PG&E",
    "bill_count": 25,
    "bill_coverage": [
        ["2012-01-05T07:00:00.000000+00:00", "2014-01-10T07:00:00.000000+00:00"],
    ],
    "bill_sources": ["pdf"],
    "interval_count": 71808,
    "interval_coverage": [
        ["2012-01-05T07:00:00.000000+00:00", "2014-01-10T07:00:00.000000+00:00"],
    ],
    "interval_sources": ["xml"],
    "exports": {
        "bills_csv": "https://utilityapi.com/api/v2/files/1238333328334323.csv",
        "bills_zip": "https://utilityapi.com/api/v2/files/18334323.zip",
        "latest_pdf": "https://utilityapi.com/api/v2/files/latest_pdf?meter=12314",
        "intervals_csv": "https://utilityapi.com/api/v2/files/1238333328334323i.csv",
        "intervals_xml": "https://utilityapi.com/api/v2/files/1238333328334323000.xml"
    },
    "blocks": ["base"],
    "base": {
        "service_identifier": "1234222222-9",
        "service_tariff": "A6X",
        "service_class": "comm-electric",
        "service_address": "222 Broadway St, Suite 100",
        "meter_numbers": ["111.00222.333.002"],
        "billing_contact": "Acme Inc.",
        "billing_address": "222 Broadway St, Suite 100",
        "billing_account": "3456222222-9",
    }
}

The api/v2/bills endpoints allow you to retrieve a utility bill data, including monthly usage and pricing. Click here to learn more about our Bill Data product.

// A bill with tier information
{
    "uid": "12382",
    "meter_uid": "58",
    "authorization_uid": "23",
    "created": "2015-03-19T20:50:41.206253+00:00",
    "updated": "2015-03-19T20:50:41.206253+00:00",
    "utility": "DEMO",
    "blocks": ["base", "sources", "line_items", "tiers"],
    "base": {
        "service_identifier": "1234567890",
        "service_tariff": "E1 XB Residential Service",
        "service_class": "res-electric",
        "service_address": "123 Main St #100, Anytown, CA 94612",
        "meter_numbers": ["A987654321"],
        "billing_contact": "ACME, INC.",
        "billing_address": "123 Main St #100, Anytown, CA 94612",
        "billing_account": "100-200-33333",
        "bill_start_date": "2015-01-07T00:00:00.000000-08:00",
        "bill_end_date": "2015-02-05T00:00:00.000000-08:00",
        "bill_total_kwh": 837.0,
        "bill_total_unit": "kwh",
        "bill_total_volume": 837.0,
        "bill_total_cost": 194.78,
    }
    "sources": [
        {
            "type": "pdf",
            "raw_url": "https://utilityapi.com/api/v2/files/abc123abc123abc123",
        }
    ]
    "line_items": [
        {
            "cost": 52.88,
            "end": "2015-02-05T08:00:00.000000+00:00",
            "name": "Tier 1 Usage",
            "rate": 0.1617,
            "start": "2015-01-07T08:00:00.000000+00:00",
            "unit": "kwh",
            "volume": 327.0
        },
        {
            "cost": 18.14,
            "end": "2015-02-05T08:00:00.000000+00:00",
            "name": "Tier 2 Usage",
            "rate": 0.18491,
            "start": "2015-01-07T08:00:00.000000+00:00",
            "unit": "kwh",
            "volume": 98.1
        },
        {
            "cost": 62.54,
            "end": "2015-02-05T08:00:00.000000+00:00",
            "name": "Tier 3 Usage",
            "rate": 0.27322,
            "start": "2015-01-07T08:00:00.000000+00:00",
            "unit": "kwh",
            "volume": 228.9
        },
        {
            "cost": 60.98,
            "end": "2015-02-05T08:00:00.000000+00:00",
            "name": "Tier 4 Usage",
            "rate": 0.33322,
            "start": "2015-01-07T08:00:00.000000+00:00",
            "unit": "kwh",
            "volume": 183.0
        },
        {
            "cost": 0.24,
            "end": "2015-02-05T08:00:00.000000+00:00",
            "name": "Energy Commission Tax",
            "rate": null,
            "start": "2015-01-07T08:00:00.000000+00:00",
            "unit": null,
            "volume": null
        }
    ]
    "tiers": [
        {
            "name": "Tier 1 Usage",
            "level": 1,
            "cost": 52.88,
            "volume": 327.0,
            "unit": "kwh"
        },
        {
            "name": "Tier 2 Usage",
            "level": 2,
            "cost": 18.14,
            "volume": 98.1,
            "unit": "kwh"
        },
        {
            "name": "Tier 3 Usage",
            "level": 3,
            "cost": 62.54,
            "volume": 228.9,
            "unit": "kwh"
        },
        {
            "name": "Tier 4 Usage",
            "level": 4,
            "cost": 60.98,
            "volume": 183.0,
            "unit": "kwh"
        }
    ]
}

The api/v2/intervals endpoints allow you to retrieve utility intervals, containing interval kwh data. Click here to learn more about our Interval Data product.

// Interval data collected for a meter
{
    "uid": "12382-123111",
    "meter_uid": "58",
    "authorization_uid": "23",
    "created": "2015-03-19T20:50:41.206253+00:00",
    "updated": "2015-03-19T20:50:41.206253+00:00",
    "utility": "DEMO",
    "blocks": ["base", "sources", "readings"],
    "base": {
        "service_identifier": "1234567890",
        "service_tariff": "E1 XB Residential Service",
        "service_address": "123 Main St #100, Anytown, CA 94612",
        "meter_numbers": ["A987654321"],
        "qualities": ["revenue"],
    },
    "notes": [],
    "sources": [
        {
            "type": "greenbutton_cmd",
            "raw_url": "https://utilityapi.com/api/v2/files/abc123abc123abc123",
        }
    ],
    "readings": [
        {
            "start": "2015-01-07T08:30:00.000000-07:00",
            "end": "2015-02-05T08:45:00.000000-07:00",
            "kwh": 18.2,
            "datapoints": [
                {
                    "type": "net",
                    "unit": "kwh",
                    "value": 18.2
                },
                {
                    "type": "max",
                    "unit": "kw",
                    "value": 81.3
                }
            ]
        },
        {
            "start": "2015-01-07T08:15:00.000000-07:00",
            "end": "2015-02-05T08:30:00.000000-07:00",
            "kwh": 10.5,
            "datapoints": [
                {
                    "type": "net",
                    "unit": "kwh",
                    "value": 10.5
                },
                {
                    "type": "max",
                    "unit": "kw",
                    "value": 46.9
                }
            ]
        },
        {
            "start": "2015-01-07T08:00:00.000000-07:00",
            "end": "2015-02-05T08:15:00.000000-07:00",
            "kwh": 12.0,
            "datapoints": [
                {
                    "type": "net",
                    "unit": "kwh",
                    "value": 12.0
                },
                {
                    "type": "max",
                    "unit": "kw",
                    "value": 50.1
                }
            ]
        },
        //...more readings
    ]
}

The api/v2/accounting endpoints allow you to retrieve accounting data, including billing account metadata and payments made to the utility. Click here to learn more about our Accounting Data product.