# Tariffs

Endpoints related to energy suppliers and their tariffs.
To create a tariff that isn't in the public list, read [Creating custom tariffs](/docs/howto/custom_tariffs) and build the request body with the [tariff builder](/tools/tariff-builder).

 - [TariffBase](https://developers.ev.energy/ev.energy-api-v2/tariffs/tariffbase.md): Schema: #/components/schemas/TariffBase
 - [Tariff](https://developers.ev.energy/ev.energy-api-v2/tariffs/tariff.md): Schema: #/components/schemas/Tariff
 - [TariffDetail](https://developers.ev.energy/ev.energy-api-v2/tariffs/tariffdetail.md): Schema: #/components/schemas/TariffDetail
 - [Rate](https://developers.ev.energy/ev.energy-api-v2/tariffs/rate.md): Schema: #/components/schemas/Rate
 - [RatePeriod](https://developers.ev.energy/ev.energy-api-v2/tariffs/rateperiod.md): Schema: #/components/schemas/RatePeriod
 - [PublicHolidayRates](https://developers.ev.energy/ev.energy-api-v2/tariffs/publicholidayrates.md): Schema: #/components/schemas/PublicHolidayRates
 - [TariffCreate](https://developers.ev.energy/ev.energy-api-v2/tariffs/tariffcreate.md): Schema: #/components/schemas/TariffCreate
 - [TariffUpdate](https://developers.ev.energy/ev.energy-api-v2/tariffs/tariffupdate.md): Schema: #/components/schemas/TariffUpdate
 - [Supplier](https://developers.ev.energy/ev.energy-api-v2/tariffs/supplier.md): Schema: #/components/schemas/Supplier
 - [Times](https://developers.ev.energy/ev.energy-api-v2/tariffs/times.md): Schema: #/components/schemas/Times
 - [PriceSummary](https://developers.ev.energy/ev.energy-api-v2/tariffs/pricesummary.md): Schema: #/components/schemas/PriceSummary
 - [DailyPrices](https://developers.ev.energy/ev.energy-api-v2/tariffs/dailyprices.md): Schema: #/components/schemas/DailyPrices
 - [Price](https://developers.ev.energy/ev.energy-api-v2/tariffs/price.md): Schema: #/components/schemas/Price
 - [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.
 - [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.
 - [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 pa
 - [POST /tariffs](https://developers.ev.energy/ev.energy-api-v2/tariffs/post-tariffs.md): Create a custom tariff from a weekly pattern of rates, optionally assigning it to a user in the same request. Use this when a user's tariff is not in the public list returned by `GET /tariffs`. See [C
 - [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. Public tariffs are visible to every application. A custom tariff created with `POST /tariffs` is private to the organisation that created it, and return
 - [PATCH /tariffs/{tariff_id}](https://developers.ev.energy/ev.energy-api-v2/tariffs/patch-tariffs-tariff_id.md): Rename or reprice a custom tariff created with `POST /tariffs`. To build a repricing body, paste the tariff's `GET /tariffs/{tariff_id}` response into the [tariff builder](/tools/tariff-builder). **Wh
 - [DELETE /tariffs/{tariff_id}](https://developers.ev.energy/ev.energy-api-v2/tariffs/delete-tariffs-tariff_id.md): Permanently delete a custom tariff and its prices. The same ownership rules as `PATCH /tariffs/{tariff_id}` apply: only the owner can delete a tariff, and public tariffs can never be deleted. 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). Prices never overlap. When prices are revised, the most recently published price wins for the time i