> ## 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.
# Revoke consumer consent
> No idea how/if this works or even why it's here as specific customer tariffs are now out of scope
Revokes a previously registered consumer consent. The supplier must stop sharing
consumer-specific data for the relevant MPXN within **60 minutes**.
Consumers can also revoke directly with their supplier, in which case the supplier
notifies the RTI User via a `consent.revoked` webhook event within 1 working day.
## OpenAPI
````yaml /tariff-interop/api/openapi-tariff.yaml delete /v1/consent/{registration_id}
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:
/v1/consent/{registration_id}:
delete:
tags:
- Consent
summary: Revoke consumer consent
description: >
No idea how/if this works or even why it's here as specific
customer tariffs are now out of scope
Revokes a previously registered consumer consent. The supplier must stop
sharing
consumer-specific data for the relevant MPXN within **60 minutes**.
Consumers can also revoke directly with their supplier, in which case
the supplier
notifies the RTI User via a `consent.revoked` webhook event within 1
working day.
operationId: revokeConsent
parameters:
- name: registration_id
in: path
required: true
description: >-
The `registration_id` UUID returned when consent was first
registered.
schema:
type: string
format: uuid
example: f47ac10b-58cc-4372-a567-0e02b2c3d479
responses:
'204':
description: Consent revoked. No content returned.
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- oauth2AuthCode:
- tariff:register
servers:
- url: https://example-supplier.co.uk
description: TI Energy Supplier API
components:
responses:
Unauthorized:
description: 401 — Missing or invalid authentication credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: >
403 — Authenticated but not authorised. Common causes: caller is not a
registered
RTI User, or active consumer consent is not in place for the requested
MPXN.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
NotFound:
description: >-
404 — The supplier MPID, tariff ID, or metering point does not exist or
is not in scope.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalServerError:
description: 500 — Unexpected server error. Retry within the 72-hour buffer window.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
schemas:
ErrorResponse:
type: object
required:
- code
- message
properties:
code:
type: string
description: Machine-readable error code.
example: tariff_not_found
message:
type: string
description: Human-readable error description.
example: No tariff found for the given tariff_id and supplier MPID.
details:
type: string
description: Additional context to help diagnose the issue.
example: >-
tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for
supplier SEBD.
securitySchemes:
oauth2AuthCode:
type: oauth2
description: >
OAuth 2.0 Authorisation Code flow for RTI User authentication and
consumer consent.
Each supplier operates its own OAuth server. In production, substitute
the
placeholder host with the relevant `url` from the Supplier Register.
OpenAPI does not permit URI templates in security scheme URLs, so a
placeholder
is used here.
flows:
authorizationCode:
authorizationUrl: https://example-supplier.co.uk/oauth2/authorize
tokenUrl: https://example-supplier.co.uk/oauth2/token
scopes:
tariff:read:consumer: Read consumer-specific tariff data for consented metering points.
tariff:register: Register and revoke consumer consent relationships.
tariff:webhook: Register and manage webhook endpoints.
````