List Tariffs

get

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

Return tariffs matching the provided filters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Use this endpoint to return tariffs that match the filters you provide.

When to use this endpoint

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

Find tariffs for a location (like zipCode or postCode, LSE, customer class, service type, or effective date.
Return tariff properties, rates, or documents by setting the corresponding populate parameter.
Filter tariffs by rate characteristics such as net metering, time-of-use rates, tiered rates, or contracted rates.
Find tariff versions by masterTariffId or retrieve the active tariff version with isActive.

Common filters

Parameter	Type	Description
`lseId`	Long	Filters tariffs for a specific LSE.
`masterTariffId`	Long	Returns versions that belong to the specified master tariff ID.
`effectiveOn`	DateTime	Returns tariffs effective on the specified date.
`openOn`	Date	Returns tariffs open to new customers on the specified date.
`isActive`	Boolean	Returns only the current active tariff version for the LSE or master tariff ID.
`customerClasses`	String	Filters by customer class, such as `RESIDENTIAL`, `GENERAL`, or `SPECIAL_USE`.
`tariffTypes`	String	Filters by tariff type, such as `DEFAULT`, `ALTERNATIVE`, `OPTIONAL_EXTRA`, or `RIDER`.
`serviceTypes`	String	Filters by service type.
`zipCode`	String	Returns tariffs for a location.
`postCode`	String	Alias for `zipCode`.
`addressString`	String	Returns tariffs for an address string.
`lat` / `lng`	Float	Latitude and longitude pair used when not supplying a ZIP code or address.
`populateProperties`	Boolean	Returns tariff properties. Defaults to `false`.
`populateRates`	Boolean	Returns tariff rate details. Defaults to `false`.
`populateDocuments`	Boolean	Returns tariff document links. Defaults to `false`.
`hasNetMetering`	Boolean	Filters tariffs by whether they have net-metered rates.
`hasTimeOfUseRates`	Boolean	Filters tariffs by whether they have time-of-use rates.
`hasTieredRates`	Boolean	Filters tariffs by whether they have tiered rates.
`hasContractedRates`	Boolean	Filters tariffs by whether they have contracted rates.

Related endpoints

file-invoice-dollar

Tariffs Overview

Learn how tariffs, rates, rate bands, documents, and properties are modeled.

history

Get Tariff History

Return the revision history for a tariff by masterTariffId.

bolt

List LSEs

Find the LSE before filtering tariffs by lseId.

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

lseId

int64

Filter tariffs for a specific LSE

masterTariffId

int64

If specified, all versions of a tariff belonging to the master tariff Id are returned.

effectiveOn

date

Only tariffs that are effective on this date

openOn

date

Only tariffs that were open (i.e. were not closed to new customers) on this date.

isActive

boolean

Only the current, active tariff version for the LSE or master tariff Id.

fromDateTime

date

Only include tariffs that are effective on or after this date

toDateTime

date

Only include tariffs that are effective on or before this date

customerClasses

string

Comma separated string that indicates the customer classes to include. Choices are: RESIDENTIAL, GENERAL, SPECIAL_USE

chargeTypes

string

Comma separated string that indicates the charge types to include. Choices are: FIXED_PRICE, CONSUMPTION_BASED, DEMAND_BASED, QUANTITY, MINIMUM, TAX, NET_EXCESS_GENERATION

tariffTypes

string

Comma separated string that indicates the tariff types to include. Choices are: DEFAULT, ALTERNATIVE, OPTIONAL_EXTRA, RIDER

serviceTypes

string

Comma separated string that indicates the service types to include. Choices are: ELECTRICITY, SOLAR_PV, ‘GAS’ (default is all serviceTypes)

privacyFlags

string

Comma separated string that indicates the privacy flags types to include. Only applicable if you publish private tariffs. Choices are: PUBLIC, UNLISTED, PRIVATE

zipCode

string

(Optional but Recommended) Use this to return just the Tariffs that are for this given location. Most Tariffs apply for a regional, not national, geography.

postCode

string

Alias for zipCode. You can use either.

lat

float

(Optional) Represents the latitude of a geographical location. This should be paired with lng when not supplying a zip code or address.

lng

float

(Optional) Represents the longitude of a geographical location. This should be paired with lat when not supplying a zip code or address.

addressString

string

An alternative to using zipCode. Use this if you do not have the address parsed out in your app, but instead have a long string. For the best results this string will contain a zipcode or post code. If you do have the address split out it is better to use postCode.

riderId

int64

When set to the masterTariffId of a Rider, this will return all of the tariffs that the rider is used on

populateProperties

boolean

Populates the properties for the returned tariffs

populateRates

boolean

Populates the rate details for the returned tariffs

populateDocuments

boolean

Populates the document links for the returned tariffs

consumption

double

Return tariffs which are eligible for this consumption amount

demand

double

Return tariffs which are eligible for this demand amount

hasNetMetering

boolean

Return tariffs which have or do not have any net metered tariff rates

hasTimeOfUseRates

boolean

Return tariffs which have or do not have any time-of-use rates

hasTieredRates

boolean

Return tariffs which have or do not have any tiered rates

hasContractedRates

boolean

Return tariffs which have or do not have any contracted rates

bundleRates

boolean

When true (false by default) the rates are summarized (bundled). Note that this only works for tariffs with a customerClass of RESIDENTIAL.

applicableRatesOnly

boolean

When true (false by default) rate applicability criteria will be applied to the rates. You’ll only get back rates that match the requests rate applicability values, or the default rate applicability value as set on the tariff.

filterRiderRates

string

Used in concert with populateRates = true, when filterRiderRates = true (false by default) rider rates will not be returned. However pointers to the riders will be returned. This is used primarily when using and existing tariff’s structure when creating private tariffs

filterByApplicability

boolean

applies a rule that results should also be filtered by applicability (i.e., additional eligibility properties).

applicabilityFilters[solarPvEligible]

boolean

which is the specific applicability criteria to filter by

fields

string

ext to return extended fields

Responses

When to use this endpoint

Common filters

Related endpoints

Request Parameters

200200

400400