Each site’s peak is its own maximum interval demand, in kW. Summing those peaks is not the coincident portfolio peak — sites do not spike in the same half-hour.
Authorizations
apiKeyAuthsessionJwt
x-api-key
string
header
required
VoltView API key. Acts as its owner, limited to the key's scopes and sites. Each endpoint lists the scope it needs.
Response
Peak demand data retrieved successfully
siteId
string
Site identifier
peak
number
Highest average power in a settlement interval (typically 30 minutes), in kW. This is measured maximum demand, not contracted MIC (kVA).
timestamp
string<date-time>
Start of the interval that set the peak
averageDemand
number
Mean power over the requested window, in kW
loadFactor
number
Average demand divided by peak, as a percentage. High values mean the site uses its peak steadily; low values mean a short spike.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"VoltView","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/voltview/3aYpuHV1JY18J-7N/logo/voltview-logo-light.svg?fit=max\u0026auto=format\u0026n=3aYpuHV1JY18J-7N\u0026q=85\u0026s=eaba765098adfe18b811fe857cc57f6c","dark":"https://mintcdn.com/voltview/3aYpuHV1JY18J-7N/logo/voltview-logo-dark.svg?fit=max\u0026auto=format\u0026n=3aYpuHV1JY18J-7N\u0026q=85\u0026s=2dca5d0b95de56e7b050b4831ea28519"},"favicon":"https://mintcdn.com/voltview/C5UR49C8q7aHbbWk/favicon.png?fit=max\u0026auto=format\u0026n=C5UR49C8q7aHbbWk\u0026q=85\u0026s=6e189de82b1d617569b5b63b460d5dd1","navbar":{"links":[{"href":"mailto:hi@voltview.co.uk","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://portal.voltview.co.uk"}},"footer":{"socials":{"x":"https://x.com/VoltViewUK","github":"https://github.com/VoltView","linkedin":"https://www.linkedin.com/company/voltview"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"voltview","hasAudioNarration":false,"actualSubdomain":"voltview","customDomains":["docs.voltview.co.uk"],"gitSource":{"type":"github","owner":"voltview","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad0950a8acb58c0d9aef18a","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Supplier Integration","count":14},{"language":"default","tag":"Sites","count":12},{"language":"default","tag":"Meters","count":9},{"language":"default","tag":"Specific Site","count":7},{"language":"default","tag":"LOA Management","count":6},{"language":"default","tag":"Bill Validation","count":4},{"language":"default","tag":"Emissions","count":4},{"language":"default","tag":"Energy Consumption","count":4},{"language":"default","tag":"User","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/sites/peak-demand-for-all-sites","slug":"/api-reference/sites/peak-demand-for-all-sites","pageMetadata":{"openapi":"get /v1/sites/peakDemand","title":"Peak demand for all sites","description":"Retrieves peak power demand data across all sites\n\n**API key:** requires the `consumption:read` scope.","href":"/api-reference/sites/peak-demand-for-all-sites"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieves peak power demand data across all sites\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"API key:\"\n }), \" requires the \", _jsx(_components.code, {\n children: \"consumption:read\"\n }), \" scope.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Each site’s `,_jsx(_components.code,{children:`peak`}),` is its own maximum interval demand, in kW. Summing those peaks is not the coincident portfolio peak — sites do not spike in the same half-hour.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /v1/sites/peakDemand","title":"Peak demand for all sites","description":"Retrieves peak power demand data across all sites\n\n**API key:** requires the `consumption:read` scope.","href":"/api-reference/sites/peak-demand-for-all-sites"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Sites"],"summary":"Peak demand for all sites","description":"Retrieves peak power demand data across all sites\n\n**API key:** requires the `consumption:read` scope.","operationId":"getSitesPeakDemand","responses":{"200":"1ed679bb-6cf5-4718-9fea-d0f9978babfe","4XX":"470cf992-5459-4461-9fe8-48c900b30cd1"},"security":["ed759ce4-ae38-4d06-8a81-69933e263e1c","c3ff5570-5bba-4a2d-a669-877cebe52595"],"x-api-key-scope":"consumption:read","method":"get","type":"path","servers":["674ebaed-7a46-48d1-9ec6-4b9d9f9699c7"],"path":"/v1/sites/peakDemand","baseUrlOptions":["https://api.voltview.co.uk"],"title":"Peak demand for all sites","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"1ed679bb-6cf5-4718-9fea-d0f9978babfe":{"description":"Peak demand data retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"siteId":{"type":"string","description":"Site identifier","uniqueKey":"items.[INDEX].siteId","typeLabel":"string"},"peak":{"type":"number","description":"Highest average power in a settlement interval (typically 30 minutes), in kW. This is measured maximum demand, not contracted MIC (kVA).","uniqueKey":"items.[INDEX].peak","typeLabel":"number"},"timestamp":{"type":"string","format":"date-time","description":"Start of the interval that set the peak","uniqueKey":"items.[INDEX].timestamp","typeLabel":"string\u003cdate-time>"},"averageDemand":{"type":"number","description":"Mean power over the requested window, in kW","uniqueKey":"items.[INDEX].averageDemand","typeLabel":"number"},"loadFactor":{"type":"number","description":"Average demand divided by peak, as a percentage. High values mean the site uses its peak steadily; low values mean a short spike.","uniqueKey":"items.[INDEX].loadFactor","typeLabel":"number"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"siteId":"\u003cstring>","peak":123,"timestamp":"2023-11-07T05:31:56Z","averageDemand":123,"loadFactor":123}]}},"exampleType":"generated"}},"exampleType":"generated"},"470cf992-5459-4461-9fe8-48c900b30cd1":{"description":"Client error response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["error"],"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","default":"Invalid request","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"error","error":{"type":"invalid_request_error","message":"Invalid request"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ed759ce4-ae38-4d06-8a81-69933e263e1c":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"VoltView API key. Acts as its owner, limited to the key's scopes and sites. Each endpoint lists the scope it needs.","scopes":[],"schemeName":"apiKeyAuth"}},"c3ff5570-5bba-4a2d-a669-877cebe52595":{"sessionJwt":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Signed-in VoltView session token. API key management always requires a session.","scopes":[],"schemeName":"sessionJwt"}}},"servers":{"674ebaed-7a46-48d1-9ec6-4b9d9f9699c7":{"url":"https://api.voltview.co.uk","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"VoltView API key. Acts as its owner, limited to the key's scopes and sites. Each endpoint lists the scope it needs.","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"VoltView API key. Acts as its owner, limited to the key's scopes and sites. Each endpoint lists the scope it needs.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Signed-in VoltView session token. API key management always requires a session.","scopes":[],"schemeName":"sessionJwt"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Signed-in VoltView session token. API key management always requires a session.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"sessionJwt","name":"Authorization"}],"title":"sessionJwt"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"voltview","siteName":"VoltView","title":"Peak demand for all sites - VoltView","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-15T08:55:46.622Z","originalFileLocation":"api-reference/sites/peak-demand-for-all-sites.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieves peak power demand data across all sites API key: requires the consumption:read scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"VoltView\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Peak demand for all sites - VoltView\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves peak power demand data across all sites API key: requires the consumption:read scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VoltView\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://voltview.mintlify.site/_mintlify/api/og/v2?division=Sites\u0026amp;title=Peak+demand+for+all+sites\u0026amp;description=Retrieves+peak+power+demand+data+across+all+sites%0A%0A**API+key%3A**+requires+the+%60consumption%3Aread%60+scope.\u0026amp;theme=6e977032fc8123d70f12ba89\u0026amp;signature=937644f5b148afe310794fdb4ecb23171c702964d081441ff1ab165edc559553\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Peak demand for all sites - VoltView\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves peak power demand data across all sites API key: requires the consumption:read scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://voltview.mintlify.site/_mintlify/api/og/v2?division=Sites\u0026amp;title=Peak+demand+for+all+sites\u0026amp;description=Retrieves+peak+power+demand+data+across+all+sites%0A%0A**API+key%3A**+requires+the+%60consumption%3Aread%60+scope.\u0026amp;theme=6e977032fc8123d70f12ba89\u0026amp;signature=937644f5b148afe310794fdb4ecb23171c702964d081441ff1ab165edc559553\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/voltview/zFms87MyYoKqr-iw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VoltView\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/sites/peak-demand-for-all-sites.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.voltview.co.uk/#organization\",\"name\":\"VoltView\",\"url\":\"https://docs.voltview.co.uk\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/voltview/3aYpuHV1JY18J-7N/logo/voltview-logo-light.svg?fit=max\u0026auto=format\u0026n=3aYpuHV1JY18J-7N\u0026q=85\u0026s=eaba765098adfe18b811fe857cc57f6c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.voltview.co.uk#website\",\"name\":\"VoltView\",\"url\":\"https://docs.voltview.co.uk\",\"publisher\":{\"@id\":\"https://docs.voltview.co.uk/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites#webpage\",\"url\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites\",\"name\":\"Peak demand for all sites\",\"description\":\"Retrieves peak power demand data across all sites API key: requires the consumption:read scope.\",\"dateModified\":\"2026-10-15T08:55:46.622Z\",\"isPartOf\":{\"@id\":\"https://docs.voltview.co.uk#website\"},\"breadcrumb\":{\"@id\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sites\",\"item\":\"https://docs.voltview.co.uk/api-reference/sites/list-all-sites\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Peak demand for all sites\",\"item\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites#apireference\",\"headline\":\"Peak demand for all sites\",\"name\":\"Peak demand for all sites\",\"description\":\"Retrieves peak power demand data across all sites API key: requires the consumption:read scope.\",\"url\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites\",\"mainEntityOfPage\":{\"@id\":\"https://docs.voltview.co.uk/api-reference/sites/peak-demand-for-all-sites#webpage\"},\"dateModified\":\"2026-10-15T08:55:46.622Z\",\"publisher\":{\"@id\":\"https://docs.voltview.co.uk/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.voltview.co.uk#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VoltView\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VoltView\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/sites/peak-demand-for-all-sites.md","siteName":"VoltView","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"User","pages":[{"openapi":"get /v1/getUser","title":"Fetch user profile","href":"/api-reference/user/fetch-user-profile"},{"openapi":"get /v1/listUsers","title":"List all users","href":"/api-reference/user/list-all-users"},{"openapi":"post /v1/createUserSiteAssignments","title":"Create user-site assignment","href":"/api-reference/user/create-user-site-assignment"},{"openapi":"delete /v1/deleteUserSiteAssignments/{userId}/{siteId}","title":"Delete user-site assignment","href":"/api-reference/user/delete-user-site-assignment"}]},{"group":"Sites","pages":[{"openapi":"get /v1/sites","title":"List all sites","href":"/api-reference/sites/list-all-sites"},{"openapi":"post /v1/createSite","title":"Create a new site","href":"/api-reference/sites/create-a-new-site"},{"openapi":"post /v1/addressLookup","title":"Address lookup","description":"Look up addresses by postcode","href":"/api-reference/sites/address-lookup"},{"openapi":"get /v1/sites/peakDemand","title":"Peak demand for all sites","href":"/api-reference/sites/peak-demand-for-all-sites"},{"openapi":"get /v1/sites/annualConsumptionAndEmissions","title":"Annual consumption and emissions for all sites","description":"Retrieves annual energy consumption and emissions data across all sites\n\n**API key:** requires the `consumption:read` scope.","href":"/api-reference/sites/annual-consumption-and-emissions-for-all-sites"},{"openapi":"get /v1/sites/annualSpendAndSavings","title":"Annual spend and savings for all sites","href":"/api-reference/sites/annual-spend-and-savings-for-all-sites"},{"openapi":"get /v1/sites/tariffs","title":"Tariffs for all sites","href":"/api-reference/sites/tariffs-for-all-sites"},{"openapi":"get /v1/sites/invoices","title":"Invoices for all sites","href":"/api-reference/sites/invoices-for-all-sites"},{"openapi":"get /v1/sites/cost","title":"Energy cost data for all sites","href":"/api-reference/sites/energy-cost-data-for-all-sites"},{"openapi":"get /v1/sites/energyIntensity","title":"Energy intensity for all sites","href":"/api-reference/sites/energy-intensity-for-all-sites"},{"openapi":"get /v1/sites/stats","title":"Statistics for all sites","href":"/api-reference/sites/statistics-for-all-sites"},{"openapi":"get /v1/energyRecommendation","title":"Energy recommendations","href":"/api-reference/sites/energy-recommendations"}]},{"group":"On-site assets","pages":[{"openapi":"get /v1/assets","title":"On-site assets","href":"/api-reference/on-site-assets/on-site-assets"},{"openapi":"get /v1/assets/solar","title":"Solar","href":"/api-reference/on-site-assets/solar"},{"openapi":"get /v1/assets/batteries","title":"Batteries","href":"/api-reference/on-site-assets/batteries"}]},{"group":"Meters","pages":[{"openapi":"get /v1/sites/{siteId}/meters","title":"Get site meters","href":"/api-reference/meters/get-site-meters"},{"openapi":"post /v1/meter/create","title":"Create meter","href":"/api-reference/meters/create-meter"},{"openapi":"delete /v1/meter/delete/{meterId}","title":"Delete meter","href":"/api-reference/meters/delete-meter"},{"openapi":"get /v1/meter/lookup","title":"Lookup meters by postcode","href":"/api-reference/meters/lookup-meters-by-postcode"},{"openapi":"get /v1/meter/lookup/{addressId}","title":"Get meter details by address ID","href":"/api-reference/meters/get-meter-details-by-address-id"},{"openapi":"post /v1/meter/lookup/bulk","title":"Bulk meter lookup","href":"/api-reference/meters/bulk-meter-lookup"},{"openapi":"get /v1/meters/{meterId}/reads","title":"Get meter reads","href":"/api-reference/meters/get-meter-reads"},{"openapi":"post /v1/meters/{meterId}/reads","title":"Create meter read","href":"/api-reference/meters/create-meter-read"},{"openapi":"delete /v1/meters/{meterId}/reads/{readId}","title":"Delete meter read","href":"/api-reference/meters/delete-meter-read"}]},{"group":"Emissions","pages":[{"openapi":"get /v1/sites/emissions","title":"Emissions data for all sites","href":"/api-reference/emissions/emissions-data-for-all-sites"},{"openapi":"get /v1/marginalCarbonIntensity","title":"Marginal carbon intensity","href":"/api-reference/emissions/marginal-carbon-intensity"},{"openapi":"get /v1/sites/{siteId}/emissions","title":"Emissions data for a specific site","href":"/api-reference/emissions/emissions-data-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/degreeDays","title":"Degree days for a specific site","href":"/api-reference/emissions/degree-days-for-a-specific-site"}]},{"group":"Specific Site","pages":[{"openapi":"get /v1/sites/{siteId}/annualConsumptionAndEmissions","title":"Annual consumption and emissions for a specific site","href":"/api-reference/specific-site/annual-consumption-and-emissions-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/annualSpendAndSavings","title":"Annual spend and savings for a specific site","href":"/api-reference/specific-site/annual-spend-and-savings-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/peakDemand","title":"Peak demand for a specific site","href":"/api-reference/specific-site/peak-demand-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/tariffs","title":"Tariffs for a specific site","href":"/api-reference/specific-site/tariffs-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/stats","title":"Statistics for a specific site","href":"/api-reference/specific-site/statistics-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/siteSpecificEnergyIntensity","title":"Energy intensity for a specific site","href":"/api-reference/specific-site/energy-intensity-for-a-specific-site"},{"openapi":"get /v1/sites/{siteId}/cost","title":"Energy cost data for a specific site","href":"/api-reference/specific-site/energy-cost-data-for-a-specific-site"}]},{"group":"Energy Consumption","pages":[{"openapi":"get /v1/sites/loadCurve","title":"Load curve for all sites","href":"/api-reference/energy-consumption/load-curve-for-all-sites"},{"openapi":"get /v1/sites/{siteId}/loadCurve","title":"Load curve for a specific site","href":"/api-reference/energy-consumption/load-curve-for-a-specific-site"},{"openapi":"get /v1/sites/timeSeries","title":"Time series data for all sites","href":"/api-reference/energy-consumption/time-series-data-for-all-sites"},{"openapi":"get /v1/sites/{siteId}/timeSeries","title":"Time series data for a specific site","href":"/api-reference/energy-consumption/time-series-data-for-a-specific-site"}]},{"group":"Supplier Integration","pages":[{"openapi":"get /v1/suppliers","title":"List available suppliers","href":"/api-reference/supplier-integration/list-available-suppliers"},{"openapi":"get /v1/suppliers/accounts","title":"Get all accounts","href":"/api-reference/supplier-integration/get-all-accounts"},{"openapi":"post /v1/suppliers/accounts","title":"Create an Account","href":"/api-reference/supplier-integration/create-an-account"},{"openapi":"get /v1/suppliers/references/{referenceId}/accountsSitesMeters","title":"Get sites and meters for a business","href":"/api-reference/supplier-integration/get-sites-and-meters-for-a-business"},{"openapi":"get /v1/suppliers/accounts/{id}","title":"Get Account Details","href":"/api-reference/supplier-integration/get-account-details"},{"openapi":"put /v1/suppliers/accounts/{id}","title":"Update Account Details","href":"/api-reference/supplier-integration/update-account-details"},{"openapi":"delete /v1/suppliers/accounts/{id}","title":"Delete an Account","href":"/api-reference/supplier-integration/delete-an-account"},{"openapi":"put /v1/suppliers/accounts/{id}/documents/upload","title":"Upload Document to Account","href":"/api-reference/supplier-integration/upload-document-to-account"},{"openapi":"get /v1/suppliers/accounts/{id}/sites","title":"Get Sites Associated with an Account","href":"/api-reference/supplier-integration/get-sites-associated-with-an-account"},{"title":"Submit meter reading to supplier","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/suppliers/accounts/{id}/readings","href":"/api-reference/supplier-integration/submit-meter-reading-to-supplier"},{"openapi":"get /v1/suppliers/businesses/{businessId}/accounts","title":"Get Supplier Accounts for a Business","href":"/api-reference/supplier-integration/get-accounts-associated-with-a-business"},{"openapi":"get /v1/suppliers/references/{referenceId}/accounts","title":"Get Accounts Associated with a Business","href":"/api-reference/supplier-integration/get-supplier-accounts-for-a-business"},{"openapi":"get /v1/suppliers/documents/sign","title":"Get Signed Document URL","href":"/api-reference/supplier-integration/get-signed-document-url"},{"openapi":"post /v1/requestUtilityIntegration","title":"Request utility integration","href":"/api-reference/supplier-integration/request-utility-integration"}]},{"group":"LOA Management","pages":[{"openapi":"post /v1/loas/parse","title":"Parse LOA (Preview)","href":"/api-reference/loa-management/parse-loa-preview"},{"openapi":"get /v1/loas","title":"List LOAs","href":"/api-reference/loa-management/list-loas"},{"openapi":"post /v1/loas","title":"Create LOA","href":"/api-reference/loa-management/create-loa"},{"openapi":"get /v1/loas/{loaId}","title":"Get LOA","href":"/api-reference/loa-management/get-loa"},{"openapi":"put /v1/loas/{loaId}/status","title":"Update LOA status","href":"/api-reference/loa-management/update-loa-status"},{"openapi":"get /v1/loas/{loaId}/document","title":"Get LOA document","href":"/api-reference/loa-management/get-loa-document"}]},{"group":"Bill Validation","pages":[{"openapi":"post /v1/billValidation/parseInvoice","title":"Parse invoice","href":"/api-reference/bill-validation/parse-invoice"},{"openapi":"post /v1/billValidation/parseContract","title":"Parse contract","href":"/api-reference/bill-validation/parse-contract"},{"openapi":"post /v1/billValidation/validateInvoice","title":"Validate invoice","href":"/api-reference/bill-validation/validate-invoice"},{"openapi":"put /v1/billValidation/updateStatus","title":"Update invoice status","href":"/api-reference/bill-validation/update-invoice-status"}]},{"group":"API keys","pages":[{"title":"List your API key metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys","href":"/api-reference/api-keys/list-your-api-key-metadata"},{"title":"Create a personal scoped read key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys","href":"/api-reference/api-keys/create-a-personal-scoped-read-key"},{"title":"Rotate your API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/rotate","href":"/api-reference/api-keys/rotate-your-api-key"},{"title":"Revoke your API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{id}/revoke","href":"/api-reference/api-keys/revoke-your-api-key"}]}]}]},"basePath":"","title":"Peak demand for all sites - VoltView","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","Page-CqcDm2To.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js","Markdown-D7pDRguu.js","clsx-2_c6mSt_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cu7_SikL.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ydqCcy4b.js"]}