Skip to main content
GET
/
v1
/
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",
      "tariff_type": "static",
      "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",
      "payment_method": "direct_debit",
      "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
Last modified on March 28, 2026