# Tariffs

Endpoints related to energy suppliers and their tariffs.

## List suppliers, sorted alphabetically by name.

 - [GET /suppliers](https://developers.ev.energy/ev.energy-api-v2/tariffs/get-suppliers.md): List all the energy suppliers known by the ev.energy system.

Use the available_for_user_id query parameter to narrow the list to only those relevant to a specific user.

## Retrieve a supplier

 - [GET /suppliers/{supplier_id}](https://developers.ev.energy/ev.energy-api-v2/tariffs/get-suppliers-suppler_id.md): Retrieve details for a single, specific energy supplier.

## List tariffs, sorted alphabetically by name.

 - [GET /tariffs](https://developers.ev.energy/ev.energy-api-v2/tariffs/get-tariffs.md): List all the energy supplier tariffs known by the ev.energy system.

Use the available_for_user_id query parameter to narrow the list to only those relevant to a specific user and supplier query parameter to list only tariffs for a specific supplier.

## Retrieve a tariff

 - [GET /tariffs/{tariff_id}](https://developers.ev.energy/ev.energy-api-v2/tariffs/get-tariffs-tariff_id.md): Retrieve details for a single, specific tariff.

## List prices for a tariff

 - [GET /tariffs/{tariff_id}/prices](https://developers.ev.energy/ev.energy-api-v2/tariffs/get-tariff-prices.md): Returns all prices for the specified tariff. Results are ordered by start time (most recent first).

Use started_at__gte and started_at__lte to filter by time range.