Consumer Tariffs

Get customer-specific tariff details

Returns tariff pricing tied to a specific consumer’s metering point. Use this when public tariff data is insufficient to determine correct pricing — for example, where a supplier’s tariff varies in ways not resolvable from name and postcode alone.

Requirements:

Caller must be a Registered TI User (RTI User).
The consumer must have granted consent to this RTI User for the specific MPXN via the OAuth 2.0 Authorisation Code flow.
The MPXN must be registered to the requested supplier.

Suppliers validate RTI User status against the register at least once per day. Requests from unregistered parties or without active consent are rejected.

GET

tariff

customer

Get customer-specific tariff details

curl --request GET \
  --url https://example-supplier.co.uk/v1/tariff/customer \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "tariff_id": "trf_a1b2c3d4e5f67890abcdef1234567890",
      "name": "Comfy Cucumber October 2026",
      "fuel_type": "electricity",
      "last_modified": "2026-11-01T10:00:00.000Z",
      "description": "A flexible electricity tariff with half-hourly prices tracking the wholesale market.",
      "version": 1,
      "energy_flow": "import",
      "meter_type": "smart",
      "customer_type": "residential",
      "ldz_region": "SE",
      "percentage_green": 27,
      "standing_charge": "0.62500",
      "vat_included": true,
      "vat_rate": 5,
      "comments": "Includes a £50 joining incentive applied as a bill credit in month 1.",
      "valid_from": "2026-11-01T10:00:00.000Z",
      "valid_to": "2026-11-01T10:00:00.000Z",
      "sellable_from": "2026-11-01T10:00:00.000Z",
      "sellable_to": "2026-11-01T10:00:00.000Z",
      "rates": [
        {
          "days_and_hours": [
            {
              "days": [
                "Mon",
                "Tue",
                "Wed",
                "Thu",
                "Fri"
              ],
              "hours": [
                {
                  "valid_from": "07:00:00",
                  "valid_to": "16:00:00",
                  "rate": [
                    {
                      "unit_price": "0.24301",
                      "to_kwh": 30
                    }
                  ]
                }
              ]
            }
          ],
          "months": [
            "All"
          ],
          "dates": [
            1
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

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.

Response

Consumer-specific tariff pricing detail.

data

object[]

Minimum array length: 1

Show child attributes

Last modified on March 28, 2026

Register consumer consent<Warning>No idea how/if this works or even why it's here as specific customer tariffs are now out of scope</Warning> Completes consumer consent registration after the OAuth 2.0 Authorisation Code flow. The supplier resolves consumer identity from the token, records consent against the MPXN, and returns a `registration_id` for managing the relationship. Consent can be granted for a one-off access or open-endedly until revoked.

Get customer-specific tariff details

curl --request GET \
  --url https://example-supplier.co.uk/v1/tariff/customer \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "tariff_id": "trf_a1b2c3d4e5f67890abcdef1234567890",
      "name": "Comfy Cucumber October 2026",
      "fuel_type": "electricity",
      "last_modified": "2026-11-01T10:00:00.000Z",
      "description": "A flexible electricity tariff with half-hourly prices tracking the wholesale market.",
      "version": 1,
      "energy_flow": "import",
      "meter_type": "smart",
      "customer_type": "residential",
      "ldz_region": "SE",
      "percentage_green": 27,
      "standing_charge": "0.62500",
      "vat_included": true,
      "vat_rate": 5,
      "comments": "Includes a £50 joining incentive applied as a bill credit in month 1.",
      "valid_from": "2026-11-01T10:00:00.000Z",
      "valid_to": "2026-11-01T10:00:00.000Z",
      "sellable_from": "2026-11-01T10:00:00.000Z",
      "sellable_to": "2026-11-01T10:00:00.000Z",
      "rates": [
        {
          "days_and_hours": [
            {
              "days": [
                "Mon",
                "Tue",
                "Wed",
                "Thu",
                "Fri"
              ],
              "hours": [
                {
                  "valid_from": "07:00:00",
                  "valid_to": "16:00:00",
                  "rate": [
                    {
                      "unit_price": "0.24301",
                      "to_kwh": 30
                    }
                  ]
                }
              ]
            }
          ],
          "months": [
            "All"
          ],
          "dates": [
            1
          ]
        }
      ]
    }
  ]
}

Documentation Index

Authorizations

Response