> ## Documentation Index
> Fetch the complete documentation index at: https://docs.auth.energy/llms.txt
> Use this file to discover all available pages before exploring further.

# Tariff event notification received by rti user

> The supplier POSTs this payload to the RTI User's registered webhook URL whenever
a relevant event occurs for a consumer with active consent.

## Event types

| Type | Meaning |
|------|---------|
| `tariff.change` | The tariff applicable to this MPXN has changed |
| `tariff.update` | Unit rate, standing charge, or time variables updated (static tariffs only) |
| `supplier.change` | The consumer has switched supplier |
| `consent.revoked` | The consumer has revoked consent for this RTI User |
| `supplier.cessation` | The supplier is ceasing voluntary TI participation for this MPXN |

> Dynamic tariffs do not generate `tariff.update` events. RTI Users must poll
> proactively using `valid_from` / `valid_to` datetimes in the rate windows.

## Notification timescales

| Event | Required within |
|-------|----------------|
| `tariff.change` / `tariff.update` | Within 60 minutes of the change taking effect |
| `consent.revoked` (consumer via supplier) | 1 working day |
| `consent.revoked` (RTI User de-registration) | 60 minutes |
| `supplier.cessation` | 3 months minimum notice |

## Signature verification

Payloads are signed. The signature is provided in the `webhook-signature` HTTP
header. RTI Users must verify this before processing.

## Retry behaviour

Suppliers buffer undelivered notifications for a minimum of **72 hours** and
retry on non-2xx responses.




## OpenAPI

````yaml /tariff-interop/api/openapi-tariff.yaml webhook tariffEvent
openapi: 3.1.0
info:
  title: Tariff Interoperability API
  version: 0.1.1.AE
  description: >
    The Tariff Interoperability (TI) API lets Energy Smart Appliances,
    optimisers, and

    third-party services access standardised electricity tariff pricing data
    directly from

    GB energy suppliers. It is defined under the Retail Energy Code (REC) and
    mandated by

    the Smart Secure Electricity Systems (SSES) Programme.


    ## Two tiers of access


    | Tier | Who can use it | Auth required |

    |------|---------------|---------------|

    | **Public Tariff Pricing Data** | Any TI User | None |

    | **Consumer Specific Tariff Information** | Registered TI Users (RTI Users)
    with active consumer consent | OAuth 2.0 |
  contact:
    name: Auth Energy
    email: contact@auth.energy
  license:
    name: |
      © 2025 Retail Energy Code Company Ltd v0.1.0.
      All modifications and improves published © 2026 Auth Energy Ltd
    url: https://auth.energy/
servers:
  - url: https://register.tariff.interop
    description: >
      Central TI Register hosted by RECCo. Serves the `/v1/suppliers` and
      `/v1/users`

      endpoints only. The `v1` path prefix identifies the API version.
  - url: https://example-supplier.co.uk
    description: >
      Placeholder for a TI Energy Supplier's own hosted API. Each supplier runs
      their

      own instance at a URL they register with RECCo — discover it from `GET
      /suppliers`.

      Serves all `/v1/tariff`, `/v1/consent`, `/v1/webhook`, `/v1/report`, and
      outbound webhook endpoints.
security: []
tags:
  - name: Registry
    description: >-
      Discover active suppliers and registered third-party users. Served by the
      central RECCo register. No authentication required for public data.
  - name: Tariffs
    description: >-
      Retrieve tariff listings and full pricing detail from a specific supplier.
      No authentication required.
  - name: Consumer Tariffs
    description: >-
      Retrieve tariff data tied to a specific consumer metering point. Requires
      OAuth 2.0 and active consumer consent.
  - name: Consent
    description: >-
      Register and revoke consumer consent linking a metering point to an RTI
      User via the OAuth 2.0 Authorisation Code flow.
  - name: Webhooks
    description: >-
      Manage webhook endpoints and receive push notifications when tariff data
      or consent state changes.
  - name: Reporting
    description: >-
      Submit periodic performance assurance metrics to RECCo (supplier
      obligation).
paths: {}

````