---
title: Encentiv API v2
description: Base URL GET /api/v2/utilities.json URL Parameters If you specify more than one type of search query, only the most specific will be used. The order from least to most specific is state_abbr, zip, nam
---

[Skip to content](https://support.encentivenergy.com/knowledge/encentiv-api-v2#main-content)

English

Show submenu for translations

![EE_logo_darkBackground.png\]](https://support.encentivenergy.com/hs-fs/hubfs/Branding%20Images%20-%20Logos%20and%20Icons/EE_logo_darkBackground.png?height=40&name=EE_logo_darkBackground.png)

- [SCHEDULE A DEMO](https://www.encentivenergy.com/schedule-a-demo/)

Open main navigation

Close main navigation

- [SCHEDULE A DEMO](https://www.encentivenergy.com/schedule-a-demo/)
- English
  
  Show submenu for translations
- Contact us

 Contact us

 Welcome! How can we help you today?

- There are no suggestions because the search field is empty.

1. [Encentiv Support Center](https://support.encentivenergy.com/knowledge?hsLang=en)
2. [Encentiv Product Documentation](https://support.encentivenergy.com/knowledge/encentiv-product-documentation?hsLang=en)

# Encentiv API v2

### Utility

#### Query utilities

  
**Base URL**

GET /api/v2/utilities.json

**URL Parameters**

| Name | Description |
| --- | --- |
| **state\_abbv** | Two letter state code |
| **zip** | Zipcode |
| **name** | Utility name |

If you specify more than one type of search query, only the most specific will be used.  
The order from least to most specific is state\_abbr, zip, name.  
**Example** /api/v2/utilities.json?state\_abbv=PA&zip=15213 will return only the utilities in the zip code 15213.

If you specify wrong combination of a search query, empty array will be returned.  
**Example** /api/v2/utilities.json?state\_abbv=PA&zip=43200

  
**Example**

GET /api/v2/utilities.json?state\_abbv=PA  
GET /api/v2/utilities.json?zip=15213  
GET /api/v2/utilities.json?name=Duquesne%20Light%20Co

  
**Returns**

`status` and `measurements` are only available if `zip` is present

\[  
    {  
        "name":         Utility Name,  
        "state":        "XX",  
        "eiacode":      "XXXXX",  
        "status":       "Open" | "Closed" | "Partial" | "Not Currently Accepting Applications" |  
                        "Waitlist" | "Funds Low" | "In Transition" | "Preview",  
        "measurements": Technologies Supported By Utility Program  
    },  
    ...  
\]

#### **Retrieve program status information**

**Base URL**

GET /api/v2/utilities/program\_status.json

**URL Parameters**

| Name | Description |
| --- | --- |
| **state\_abbv** | Two letter state code |
| **eiacode** | 5 digit EIA number for utility operating company |

  
**Example**

GET /api/v2/utilities/program\_status.json?state\_abbv=AL  
GET /api/v2/utilities/program\_status.json?state\_abbv=AL&eiacode=00241

  
**Returns**

\[  
    {  
        "utility":                  Utility Name ,  
        "eiacode":                  "00241",  
        "state":                    "AL",  
        "status":                   "Open" | "Closed" | "Partial" | "Not Currently Accepting Applications" |  
                                    "Waitlist" | "Funds Low" | "In Transition" | "Preview" ,  
        "pre\_approval":             "Yes" | "No",  
        "pre\_inspection":           "Yes" | "No",  
        "post\_inspection":          "Yes" | "No",  
        "pre\_approved\_contractor":  "Yes" | "No",  
        "rebate\_cap":               Cap Information ,  
        "max\_payout\_per\_period":    "$100,000",  
        "app\_submitter":            "Anyone" | "Owner" | "Registered",  
        "eligibility":              Eligibility Information,  
        "measurements":             Technologies Supported By Utility Program  
    },  
    ...  
\]

 

#### Retrieve building types for utility

**Base URL**

GET /api/v2/utilities/building\_types.json

**URL Parameters**

| Name | Description |
| --- | --- |
| **state\_abbv** | Two letter state code |
| **eiacode** | 5 digit EIA number for utility operating company |

  
**Example**

GET /api/v2/utilities/building\_types.json?state\_abbv=PA&eiacode=05487

  
**Returns**

\[  
    {  
        "id" :      Building Type ID,  
        "abbr":     Building Type Abbr,  
        "category": Apply To This Product Category  
        "cf" :      Control Factor,  
        "hou":      Building Hours,  
        "name":     Building Type Name  
    },  
    ...  
\]

- [General](https://support.encentivenergy.com/knowledge/general?hsLang=en)
- [Features + Functionality](https://support.encentivenergy.com/knowledge/features-functionality?hsLang=en#main-content)
  
  
  
  
  
    - [Product Awareness](https://support.encentivenergy.com/knowledge/features-functionality?hsLang=en#product-awareness)
    - [Payback Calculator](https://support.encentivenergy.com/knowledge/features-functionality?hsLang=en#payback-calculator)
    - [Rebate Finder](https://support.encentivenergy.com/knowledge/features-functionality?hsLang=en#rebate-finder)
- [Encentiv Product Documentation](https://support.encentivenergy.com/knowledge/encentiv-product-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [Rebate Finder](https://support.encentivenergy.com/knowledge/encentiv-product-documentation?hsLang=en#rebate-finder)
    - [Payback Calculator](https://support.encentivenergy.com/knowledge/encentiv-product-documentation?hsLang=en#payback-calculator)

- [SCHEDULE A DEMO](https://www.encentivenergy.com/schedule-a-demo/)

[![ee_full logo for light backgrounds](https://support.encentivenergy.com/hs-fs/hubfs/ee_full%20logo%20for%20light%20backgrounds.png?width=250&height=48&name=ee_full%20logo%20for%20light%20backgrounds.png "ee_full logo for light backgrounds")](http://encentivenergy.com)

Need more help? Email support@encentivenergy.com

Copyright © 2026, Encentiv Energy, Inc.