Skip to main content

GET /consumption/v1/{mpid}/load-shapes/totals

Returns the latest settlement load shape totals data for a settlement date and optional market filters.

Request​

Method and path:

  • GET /consumption/v1/{mpid}/load-shapes/totals?settlement_date=2026-03-01&gsp_group_id=A&connection_type=H&market_segment=A&domestic_indicator=Y&mqid=AI

Headers:

  • X-API-KEY (required): string, API key used for tenant authorization.

Path parameters:

  • mpid (required): string supplier MPID.

Query parameters:

  • settlement_date (required): string date in YYYY-MM-DD.
  • gsp_group_id (optional): string GSP group identifier.
  • connection_type (optional): string connection type.
  • market_segment (optional): string market segment.
  • domestic_indicator (optional): string domestic indicator.
  • mqid (optional): string measurement quantity ID.

Request body:

  • None.

Response​

Success:

  • 200 OK
  • Body type: SettlementLoadShapeTotalsResponse
{
  "received_on": "2026-03-20T01:00:00+00:00",
  "settlement_date": "2026-03-01T00:00:00+00:00",
  "gsp_group_id": "A",
  "connection_type": "H",
  "market_segment": "A",
  "domestic_indicator": "Y",
  "mqid": "AI",
  "annual_load_shape_total": "12.88400",
  "lss_totals_data": [
    {
      "day_total": "10.25000",
      "day_peak_total": "6.10000",
      "day_off_peak_total": "4.15000",
      "seven_day_rolling_total": "72.30000",
      "seven_day_rolling_peak_total": "41.90000",
      "seven_day_rolling_off_peak_total": "30.40000"
    }
  ]
}

No content case:

  • 204 No Content when no load shape totals data matches the filters.

Validation error:

  • 422-style SSI validation response when settlement_date is not YYYY-MM-DD.

Full field definitions: