Tariffs
Get tariff details
Returns full pricing detail for a specific tariff: unit rates, standing charge, validity windows, regional pricing, and green energy percentage.
Pass region to filter results for a specific Network Operator zone where the
supplier’s pricing varies by location. No authentication required.
GET
/
v1
/
tariff
/
{mpid}
/
{tariff_id}
Get tariff details
curl --request GET \
--url https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}import requests
url = "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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
]
}
]
}
]
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}Path Parameters
Four-character Market Participant Identifier (MPID) of the supplier.
Required string length:
4Example:
"SEBD"
UUID of the tariff, as returned by GET /tariff/{mpid}.
Example:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Query Parameters
LDZ region code to filter pricing by geographic zone. See LdzRegion for valid values.
Local Distribution Zone (LDZ) or Network Operator region code. Identifies the
geographic pricing zone for this tariff.
Available options:
SC, NO, NE, NWT, WMD, EM, EA, NT, SO, SE, WN, WW, SW Example:
"SE"
Response
Full tariff pricing detail.
Minimum array length:
1Show child attributes
Show child attributes
Last modified on March 28, 2026
⌘I
Get tariff details
curl --request GET \
--url https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}import requests
url = "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://example-supplier.co.uk/v1/tariff/{mpid}/{tariff_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"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
]
}
]
}
]
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}{
"code": "tariff_not_found",
"message": "No tariff found for the given tariff_id and supplier MPID.",
"details": "tariff_id a1b2c3d4-e5f6-7890-abcd-ef1234567890 does not exist for supplier SEBD."
}
