List LSEs

get

https://api.genability.com/rest/public/lses

Return a full or filtered list of Load Serving Entities (LSEs).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Use this endpoint to return a full or filtered list of Load Serving Entities (LSEs).

When to use this endpoint

Use GET /rest/public/lses when you need to:

Find utilities for a ZIP or postal code.
Search for an LSE by name or other searchable attributes.
Filter LSEs by ownership structure or service type.

Common filters

Parameter	Type	Description
`searchOn`	String	Searches within one or more LSE attributes.
`zipCode`	String	ZIP or postal code to return LSEs for. Use with `country` when possible.
`postCode`	String	Alias for `zipCode`.
`country`	String	ISO country code for the ZIP or postal code.
`ownerships`	String	Comma-separated ownership structures, such as `INVESTOR`, `COOP`, or `MUNI`.
`serviceTypes`	String	Comma-separated service types, such as `ELECTRICITY` or `SOLAR_PV`.
`residentialServiceTypes`	String	Comma-separated service types available to residential customers.
`commercialServiceTypes`	String	Comma-separated service types available to commercial customers.

Related endpoints

bolt

Load Serving Entities (LSEs)

Learn how LSE data is modeled.

building

Get LSE by ID

Retrieve one LSE by lseId.

file-invoice-dollar

List Tariffs

Find tariffs for an LSE or location.

Request Parameters

Along with the standard pagination parameters, searching and sorting parameters, and the required security parameters, the following parameters are available as part of the request:

Query Params

searchOn

string

This is from the standard searching and sorting parameters. You can search within one or more of the attributes within the LSE object (see above).

zipCode

string

Zip or post code where you would like to see a list of LSEs for (e.g. 5 digit ZIP code for USA). Most countries have regional, not national, Utility Service Areas. When populating this field you should also populate country too. (Recommended)

postCode

string

Alias for zipCode, you can use either.

country

string

Use an ISO Country Code when passing in a zipCode or postCode, and set it to the ISO Country Code of your zipCode or postCode since some countries use the same format

ownerships

array of strings

Filter results by the type of ownership structure for the LSE. Values include "INVESTOR", "COOP", "MUNI", but see ownership field above for complete list.

ownerships

serviceTypes

array of strings

Filter results to LSEs that just offer this service type to a customer class. Valid values include "ELECTRICITY" and "SOLAR_PV"

serviceTypes

residentialServiceTypes

array of strings

Filter results to LSEs that just offer this service type to their residential customers. Valid values include "ELECTRICITY" and "SOLAR_PV"

residentialServiceTypes

commercialServiceTypes

array of strings

Filter results to LSEs that just offer this service type to their commercial (business) customers. Valid values include "ELECTRICITY" and "SOLAR_PV"

commercialServiceTypes

industrialServiceTypes

array of strings

Filter results to LSEs that just offer this service type to their industrial customers. Valid values include "ELECTRICITY" and "SOLAR_PV"

industrialServiceTypes

transportationServiceTypes

array of strings

Filter results to LSEs that just offer this service type to their transportation customers. Valid values include "ELECTRICITY" and "SOLAR_PV" (Optional).

transportationServiceTypes

Responses

When to use this endpoint

Common filters

Related endpoints

Request Parameters

200200

400400