POST request/prices/electricity/acquisition

Gets available Acquisition Electricity Energy Plans. Note that Supplier Names and Tariff Names returned are shuffled on every new request, but are consistent within a single result set. Standing Chanrge Unit always PencePerDay and all the Usage Unit Annually

Request Information

URI Parameters

None.

Body Parameters

Request

Name	Type	Additional information
Mpan	string	Required
ContractEndDate	date	None.
LengthOfContract	byte	None.
Consumption	integer	Required Range: inclusive between 0 and 2147483647
ConsumptionPeriodId	byte	None.

Request Formats

application/json, text/json

Sample:

{
  "mpan": "sample string 1",
  "contractEndDate": "2026-06-06T03:00:48.8088103+00:00",
  "lengthOfContract": 64,
  "consumption": 1,
  "consumptionPeriodId": 64
}

application/xml, text/xml

Sample:

<Request xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SqueakyAPI.Models.PriceAcquisitionDto">
  <Consumption>1</Consumption>
  <ConsumptionPeriodId>64</ConsumptionPeriodId>
  <ContractEndDate>2026-06-06T03:00:48.8088103+00:00</ContractEndDate>
  <LengthOfContract>64</LengthOfContract>
  <Mpan>sample string 1</Mpan>
</Request>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Collection of ResponseAcquisitionTariff

Name	Type	Additional information
ContractType	string	None.
HasAutomaticMeterReading	boolean	None.
SupplierName	string	None.
TariffName	string	None.
PaymentType	string	None.
ComparisonType	string	None.
ContractLength	byte	None.
StandingCharge	decimal number	None.
RateType	string	None.
PriceValidFrom	date	None.
PriceValidTo	date	None.
NewContractStartDate	date	None.
NewContractEndDate	date	None.
LowerConsumptionLimit	integer	None.
UpperConsumptionLimit	integer	None.
TariffRateInfos	Collection of TariffRateInfo	None.
Big6OrOpus	boolean	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "contractType": "sample string 1",
    "hasAutomaticMeterReading": true,
    "supplierName": "sample string 2",
    "tariffName": "sample string 3",
    "paymentType": "sample string 4",
    "comparisonType": "sample string 5",
    "contractLength": 64,
    "standingCharge": 1.0,
    "rateType": "sample string 6",
    "priceValidFrom": "2026-06-06T03:00:49.4493153+00:00",
    "priceValidTo": "2026-06-06T03:00:49.4493153+00:00",
    "newContractStartDate": "2026-06-06T03:00:49.4493153+00:00",
    "newContractEndDate": "2026-06-06T03:00:49.4493153+00:00",
    "lowerConsumptionLimit": 1,
    "upperConsumptionLimit": 1,
    "tariffRateInfos": [
      {
        "rateMeterType": 0,
        "unitRate": 1.0
      },
      {
        "rateMeterType": 0,
        "unitRate": 1.0
      }
    ],
    "big6OrOpus": true
  },
  {
    "contractType": "sample string 1",
    "hasAutomaticMeterReading": true,
    "supplierName": "sample string 2",
    "tariffName": "sample string 3",
    "paymentType": "sample string 4",
    "comparisonType": "sample string 5",
    "contractLength": 64,
    "standingCharge": 1.0,
    "rateType": "sample string 6",
    "priceValidFrom": "2026-06-06T03:00:49.4493153+00:00",
    "priceValidTo": "2026-06-06T03:00:49.4493153+00:00",
    "newContractStartDate": "2026-06-06T03:00:49.4493153+00:00",
    "newContractEndDate": "2026-06-06T03:00:49.4493153+00:00",
    "lowerConsumptionLimit": 1,
    "upperConsumptionLimit": 1,
    "tariffRateInfos": [
      {
        "rateMeterType": 0,
        "unitRate": 1.0
      },
      {
        "rateMeterType": 0,
        "unitRate": 1.0
      }
    ],
    "big6OrOpus": true
  }
]

application/xml, text/xml

Sample:

<ArrayOfResponseAcquisitionTariff xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SqueakyAPI.Models.PriceAcquisitionDto">
  <ResponseAcquisitionTariff>
    <Big6OrOpus>true</Big6OrOpus>
    <ComparisonType>sample string 5</ComparisonType>
    <ContractLength>64</ContractLength>
    <ContractType>sample string 1</ContractType>
    <HasAutomaticMeterReading>true</HasAutomaticMeterReading>
    <LowerConsumptionLimit>1</LowerConsumptionLimit>
    <NewContractEndDate>2026-06-06T03:00:49.4493153+00:00</NewContractEndDate>
    <NewContractStartDate>2026-06-06T03:00:49.4493153+00:00</NewContractStartDate>
    <PaymentType>sample string 4</PaymentType>
    <PriceValidFrom>2026-06-06T03:00:49.4493153+00:00</PriceValidFrom>
    <PriceValidTo>2026-06-06T03:00:49.4493153+00:00</PriceValidTo>
    <RateType>sample string 6</RateType>
    <StandingCharge>1</StandingCharge>
    <SupplierName>sample string 2</SupplierName>
    <TariffName>sample string 3</TariffName>
    <TariffRateInfos xmlns:d3p1="http://schemas.datacontract.org/2004/07/SqueakyAPI.Domain.Switch">
      <d3p1:TariffRateInfo>
        <d3p1:RateMeterType>Single</d3p1:RateMeterType>
        <d3p1:UnitRate>1</d3p1:UnitRate>
      </d3p1:TariffRateInfo>
      <d3p1:TariffRateInfo>
        <d3p1:RateMeterType>Single</d3p1:RateMeterType>
        <d3p1:UnitRate>1</d3p1:UnitRate>
      </d3p1:TariffRateInfo>
    </TariffRateInfos>
    <UpperConsumptionLimit>1</UpperConsumptionLimit>
  </ResponseAcquisitionTariff>
  <ResponseAcquisitionTariff>
    <Big6OrOpus>true</Big6OrOpus>
    <ComparisonType>sample string 5</ComparisonType>
    <ContractLength>64</ContractLength>
    <ContractType>sample string 1</ContractType>
    <HasAutomaticMeterReading>true</HasAutomaticMeterReading>
    <LowerConsumptionLimit>1</LowerConsumptionLimit>
    <NewContractEndDate>2026-06-06T03:00:49.4493153+00:00</NewContractEndDate>
    <NewContractStartDate>2026-06-06T03:00:49.4493153+00:00</NewContractStartDate>
    <PaymentType>sample string 4</PaymentType>
    <PriceValidFrom>2026-06-06T03:00:49.4493153+00:00</PriceValidFrom>
    <PriceValidTo>2026-06-06T03:00:49.4493153+00:00</PriceValidTo>
    <RateType>sample string 6</RateType>
    <StandingCharge>1</StandingCharge>
    <SupplierName>sample string 2</SupplierName>
    <TariffName>sample string 3</TariffName>
    <TariffRateInfos xmlns:d3p1="http://schemas.datacontract.org/2004/07/SqueakyAPI.Domain.Switch">
      <d3p1:TariffRateInfo>
        <d3p1:RateMeterType>Single</d3p1:RateMeterType>
        <d3p1:UnitRate>1</d3p1:UnitRate>
      </d3p1:TariffRateInfo>
      <d3p1:TariffRateInfo>
        <d3p1:RateMeterType>Single</d3p1:RateMeterType>
        <d3p1:UnitRate>1</d3p1:UnitRate>
      </d3p1:TariffRateInfo>
    </TariffRateInfos>
    <UpperConsumptionLimit>1</UpperConsumptionLimit>
  </ResponseAcquisitionTariff>
</ArrayOfResponseAcquisitionTariff>