---
title: "Asset Tariff Update Event"
method: POST
path: "/entities/asset/{asset_id}/event/tariff-update"
tags: ["4. Assets"]
---

# Asset Tariff Update Event

`POST /entities/asset/{asset_id}/event/tariff-update`

## Request

- Base URL: `https://api-sandbox.axle.energy`
- URL: `https://api-sandbox.axle.energy/entities/asset/{asset_id}/event/tariff-update`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token-form`

Send notification of a tariff update for an asset.

The `off_peak_times` field must comply with the OSM opening hours standard (https://wiki.openstreetmap.org/wiki/Key:opening_hours) and have a valid timezone, or a 400 error will be returned.

The same off-peak times apply every day, day-of-week selectors are not supported. Use `,` to separate multiple time ranges. Common examples:
- Same-day off-peak (e.g. midnight to 7am): `00:00-07:00`
- Overnight off-peak (e.g. 11:30pm to 5:30am): `00:00-05:30, 23:30-24:00`

## Path parameters

- `asset_id` string, uuid, required

## Request body

- TariffUpdateEventRequest: Request model for a user's tariff update.
  - `tariff` Tariff, required
    - `off_peak_times` string, required
    - `timezone` string, required
    - `tariff_type` 'single_rate' | 'dual_rate' | 'dynamic' | 'smart' | 'unknown'

## Response `200`

Tariff update event successfully processed

- unknown

## Other responses

- `400`: Invalid tariff format or timezone
- `404`: Asset not found or not authorized to access
- `422`: Validation Error
- `500`: Server error while processing event

## Changes

- **2026-11-03** `b0b07b1dbf12`: 7 breaking
  - added `#/components/schemas/TariffType` to the `tariff/allOf[subschema #1: Tariff]/tariff_type` request property `allOf` list
  - removed the enum value `dual_rate` of the request property `tariff/allOf[subschema #1: Tariff]/tariff_type`
  - removed the enum value `dynamic` of the request property `tariff/allOf[subschema #1: Tariff]/tariff_type`
  - removed the enum value `single_rate` of the request property `tariff/allOf[subschema #1: Tariff]/tariff_type`
  - …3 more

[Operation history](https://skmtc.dev/axle/apis/axle-api-docs/changes/entities/asset/:asset_id/event/tariff-update/post.md)

---

[API](https://skmtc.dev/axle/apis/axle-api-docs.md) - [All operations](https://skmtc.dev/axle/apis/axle-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/axle/apis/axle-api-docs/revisions/b0b07b1dbf12?raw)