Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.
When true, the response includes all intermediate pipeline time series (e.g. hourly-power-offtake, monthly-peak) in addition to the final cost. When false (default), only the cost time series is returned per component.
End of the calculation period (exclusive). Must include timezone offset and be after start_time. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone.
Start of the calculation period (inclusive). Must include timezone offset. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone (e.g. 2026-01-01T00:00:00+01:00 for Europe/Stockholm).
Results per tariff component that is active within the requested period.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Engrate Developer Documentation","description":"Engrate is the building blocks for your energy management and optimization applications. Without the complexity of traditional integration platforms our developer-first approach gets you from concept to production in days, not months.","colors":{"primary":"#FFBB00","light":"#FFBB00","dark":"#FFBB00"},"logo":{"light":"https://mintcdn.com/engrate/zV_tsIFvjMafIhqO/images/logo-light.svg?fit=max\u0026auto=format\u0026n=zV_tsIFvjMafIhqO\u0026q=85\u0026s=0a166849b56cc0dbfbb1584afda2d0ba","dark":"https://mintcdn.com/engrate/zV_tsIFvjMafIhqO/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=zV_tsIFvjMafIhqO\u0026q=85\u0026s=79fb04f9456ebd05ae69f107341c5d81"},"favicon":"https://mintcdn.com/engrate/0gbHzEYX3GoHU0wy/favicon.ico?fit=max\u0026auto=format\u0026n=0gbHzEYX3GoHU0wy\u0026q=85\u0026s=498b7c6e50fdffeb3edaab1e0272101b","navbar":{"links":[{"href":"mailto:hello@engrate.io","label":"Support"}],"primary":{"type":"button","label":"Contact us","href":"mailto:hello@engrate.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/engrate"}},"fonts":{"family":"Work Sans","format":"woff2"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"engrate","hasAudioNarration":false,"actualSubdomain":"engrate","customDomains":["docs.engrate.io"],"gitSource":{"type":"github","owner":"engrate","repo":"eg-core","deployBranch":"main","contentDirectory":"docs/public/mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9ee7575120cb36f290e4a","collectionId":"51b35a91-5dca-4fc4-8364-55a1049fcb8d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9ee7575120cb36f290e4a"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aeb1380a60f76c94452a881","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API reference","count":106},{"language":"default","tag":"Market Communication","count":55},{"language":"default","tag":"Cost of Energy","count":43},{"language":"default","tag":"Models","count":33},{"language":"default","tag":"Schedules","count":20},{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"Allocations","count":19},{"language":"default","tag":"Core","count":19},{"language":"default","tag":"Functions","count":12},{"language":"default","tag":"Conditions","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":true},"customCss":[{"filePath":"global.css","content":".eg-dataset>rect{fill:#dbeafe!important;stroke:#0080ff!important}.eg-dataset .nodeLabel{color:#002fa7!important}.eg-fn>rect{fill:#f5f5f5!important;stroke:#e5e5e5!important}.eg-fn .nodeLabel{color:#4a4a4a!important}.eg-output>rect{fill:#d1fae5!important;stroke:#10b981!important}.eg-output .nodeLabel{color:#064e3b!important}.edgeLabel{font-size:.75rem}.edgeLabel,.edgeLabel p{background-color:transparent!important}.edgeLabel .labelBkg{background:#dbeafe!important;border:1px solid #0080ff;color:#002fa7;padding:2px 10px;border-radius:999px}.labelBkg:has(>span.edgeLabel:empty){background:0 0!important;border:0!important;padding:0!important}html.dark .eg-dataset>rect{fill:#1e3a5f!important;stroke:#60a5fa!important}html.dark .eg-dataset .nodeLabel{color:#dbeafe!important}html.dark .eg-fn>rect{fill:#374151!important;stroke:#4b5563!important}html.dark .eg-fn .nodeLabel{color:#e5e7eb!important}html.dark .eg-output>rect{fill:#064e3b!important;stroke:#34d399!important}html.dark .eg-output .nodeLabel{color:#d1fae5!important}html.dark .edgePath path,html.dark .flowchart-link,html.dark marker path,html.dark path.flowchart-link{stroke:#9ca3af!important}html.dark marker path{fill:#9ca3af!important}html.dark .edgeLabel .labelBkg{background:#1e3a5f!important;border-color:#60a5fa;color:#dbeafe!important}html.dark .edgeLabel .labelBkg span,html.dark .edgeLabel span{color:#dbeafe!important}"}],"page":{"pagePath":"api-reference/calculate-tariff","slug":"/api-reference/calculate-tariff","pageMetadata":{"title":"Calculate Tariff","description":"Calculate costs for a [Tariff](/api-reference/cost-of-energy/models/tariff).\n\nExecutes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline `time_series`, persisted `profiles`, or a combination of both. Dataset names must not overlap between the two inputs.","deprecated":null,"version":null,"openapi":"/openapi.json post /cost-of-energy/v1/calculate","href":"/api-reference/calculate-tariff","autogeneratedByOpenApi":true},"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 a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Calculate costs for a \", _jsx(_components.a, {\n href: \"/api-reference/cost-of-energy/models/tariff\",\n children: \"Tariff\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline \", _jsx(_components.code, {\n children: \"time_series\"\n }), \", persisted \", _jsx(_components.code, {\n children: \"profiles\"\n }), \", or a combination of both. Dataset names must not overlap between the two inputs.\"]\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{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":{"title":"Calculate Tariff","description":"Calculate costs for a [Tariff](/api-reference/cost-of-energy/models/tariff).\n\nExecutes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline `time_series`, persisted `profiles`, or a combination of both. Dataset names must not overlap between the two inputs.","deprecated":null,"version":null,"openapi":"/openapi.json post /cost-of-energy/v1/calculate","href":"/api-reference/calculate-tariff","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Calculate costs for a [Tariff](/api-reference/cost-of-energy/models/tariff).\n\nExecutes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline `time_series`, persisted `profiles`, or a combination of both. Dataset names must not overlap between the two inputs.","operationId":"calculate_tariff_cost_of_energy_v1_calculate_post","parameters":["6612f3e7-5821-4a27-b10c-5e5f39cfbeac"],"requestBody":"fc36e539-c7fc-4784-a1ed-164b5a6aa34d","responses":{"200":"a6d77080-9031-4cca-b500-569616ab93d9","400":"2ef9da09-08ec-401f-a8fc-a62cd322314a","404":"737fd124-8065-487c-b8c6-506e3ac6ed73","422":"97718b09-dd0e-4f3f-9c5f-ff4b7b5e9572"},"summary":"Calculate Tariff","method":"post","type":"path","servers":["2219c5a9-9f66-4c8c-9e40-d681b2196046"],"security":["97dd253d-026b-47d1-8ac4-7d4d04c3064e"],"path":"/cost-of-energy/v1/calculate","baseUrlOptions":["https://api.engrate.io"],"title":"Calculate Tariff","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6612f3e7-5821-4a27-b10c-5e5f39cfbeac":{"description":"When true, the response includes all intermediate pipeline time series (e.g. hourly-power-offtake, monthly-peak) in addition to the final cost. When false (default), only the cost time series is returned per component.","in":"query","name":"include_intermediate_time_series","required":false,"schema":{"default":false,"description":"When true, the response includes all intermediate pipeline time series (e.g. hourly-power-offtake, monthly-peak) in addition to the final cost. When false (default), only the cost time series is returned per component.","title":"Include intermediate time series","type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}}},"requestBody":{"content":{"application/json":{"schema":{"example":{"end_time":"2026-01-01T00:30:00+01:00","profiles":[{"name":"quarter-hourly-day-ahead-price-se1","profile_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}],"start_time":"2026-01-01T00:00:00+01:00","tariff_id":"123e4567-e89b-12d3-a456-426614174000","time_series":[{"name":"quarter-hourly-energy-offtake","values":[1.5,1.2]}]},"properties":{"end_time":{"description":"End of the calculation period (exclusive). Must include timezone offset and be after start_time. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone.","format":"date-time","title":"End Time","type":"string","isRequired":true,"uniqueKey":"end_time","typeLabel":"string\u003cdate-time>"},"start_time":{"description":"Start of the calculation period (inclusive). Must include timezone offset. For correct monthly/daily bucketing, align to local midnight in the tariff's timezone (e.g. 2026-01-01T00:00:00+01:00 for Europe/Stockholm).","format":"date-time","title":"Start Time","type":"string","isRequired":true,"uniqueKey":"start_time","typeLabel":"string\u003cdate-time>"},"tariff_id":{"description":"ID of the tariff to calculate.","format":"uuid","title":"Tariff Id","type":"string","isRequired":true,"uniqueKey":"tariff_id","typeLabel":"string\u003cuuid>"},"profiles":{"oneOf":[{"type":"array","items":{"description":"A reference to a persisted profile to use as input for a dataset.","example":{"name":"quarter-hourly-day-ahead-price-se1","profile_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"},"properties":{"name":{"description":"Dataset identifier.","title":"Name","type":"string","isRequired":true,"uniqueKey":"profiles.oneOf.0.items.[INDEX].name","typeLabel":"string"},"profile_id":{"description":"UUID of the persisted profile to use as input for this dataset.","format":"uuid","title":"Profile Id","type":"string","isRequired":true,"uniqueKey":"profiles.oneOf.0.items.[INDEX].profile_id","typeLabel":"string\u003cuuid>"}},"required":["name","profile_id"],"title":"InputProfile","type":"object","uniqueKey":"profiles.oneOf.0.items.[INDEX]","typeLabel":"InputProfile · object"},"title":"Profiles","description":"Profile references for datasets. Each entry maps a dataset to a persisted profile UUID. Can be combined with time_series.","uniqueKey":"profiles.oneOf.0","typeLabel":"InputProfile · object[]"},{"type":"null","title":"Profiles","description":"Profile references for datasets. Each entry maps a dataset to a persisted profile UUID. Can be combined with time_series.","uniqueKey":"profiles.oneOf.1","typeLabel":"null"}],"uniqueKey":"profiles","typeLabel":"InputProfile · object[] | null"},"time_series":{"oneOf":[{"type":"array","items":{"description":"A time series of data for a registered dataset that is input for a tariff component.\n\nUse ``null`` in the values array to represent absent values.","example":{"name":"quarter-hourly-energy-offtake","values":[1.5,1.2]},"properties":{"name":{"description":"Dataset identifier.","title":"Name","type":"string","isRequired":true,"uniqueKey":"time_series.oneOf.0.items.[INDEX].name","typeLabel":"string"},"values":{"description":"Ordered values aligned to the implicit timestamp grid. Use null for absent values.","items":{"oneOf":[{"type":"number","uniqueKey":"time_series.oneOf.0.items.[INDEX].values.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"time_series.oneOf.0.items.[INDEX].values.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"time_series.oneOf.0.items.[INDEX].values.items.[INDEX]","typeLabel":"number | null"},"title":"Values","type":"array","isRequired":true,"uniqueKey":"time_series.oneOf.0.items.[INDEX].values","typeLabel":"(number | null)[]"}},"required":["name","values"],"title":"InputTimeSeries","type":"object","uniqueKey":"time_series.oneOf.0.items.[INDEX]","typeLabel":"InputTimeSeries · object"},"title":"Time Series","description":"Input time series data for each dataset required by the tariff's active components. Can be combined with profiles.","uniqueKey":"time_series.oneOf.0","typeLabel":"InputTimeSeries · object[]"},{"type":"null","title":"Time Series","description":"Input time series data for each dataset required by the tariff's active components. Can be combined with profiles.","uniqueKey":"time_series.oneOf.1","typeLabel":"null"}],"uniqueKey":"time_series","typeLabel":"InputTimeSeries · object[] | null"}},"required":["end_time","start_time","tariff_id"],"title":"CalculateTariffRequest","type":"object","uniqueKey":"","typeLabel":"CalculateTariffRequest · object"},"examples":{"Example":{"title":"Example","value":{"end_time":"2026-01-01T00:30:00+01:00","profiles":[{"name":"quarter-hourly-day-ahead-price-se1","profile_id":"a1b2c3d4-e5f6-7890-abcd-ef1234567890"}],"start_time":"2026-01-01T00:00:00+01:00","tariff_id":"123e4567-e89b-12d3-a456-426614174000","time_series":[{"name":"quarter-hourly-energy-offtake","values":[1.5,1.2]}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"a6d77080-9031-4cca-b500-569616ab93d9":{"content":{"application/json":{"schema":{"example":{"components":[{"end_time":"2026-01-01T00:30:00+01:00","name":"Energiskatt","start_time":"2026-01-01T00:00:00+01:00","time_series":[{"name":"cost","resolution":"quarter_hourly","unit":"SEK","values":[0.54,0.432]}]}]},"properties":{"components":{"description":"Results per tariff component that is active within the requested period.","items":{"example":{"end_time":"2026-01-01T00:30:00+01:00","name":"Energiskatt","start_time":"2026-01-01T00:00:00+01:00","time_series":[{"name":"cost","resolution":"quarter_hourly","unit":"SEK","values":[0.54,0.432]}]},"properties":{"end_time":{"description":"Actual end of the data range (after clipping to the component's applicable window).","format":"date-time","title":"End Time","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].end_time","typeLabel":"string\u003cdate-time>"},"name":{"title":"Name","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].name","typeLabel":"string"},"start_time":{"description":"Actual start of the data range (after clipping to the component's applicable window).","format":"date-time","title":"Start Time","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].start_time","typeLabel":"string\u003cdate-time>"},"time_series":{"description":"Calculated time series for this component. By default only the final cost time series is included. Pass include_intermediate_time_series=true to also get intermediate pipeline outputs.","items":{"description":"A named time series returned from a calculation, with explicit resolution and unit.","example":{"name":"cost","resolution":"quarter_hourly","unit":"SEK","values":[0.54,0.432]},"properties":{"name":{"description":"Time series identifier.","title":"Name","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].name","typeLabel":"string"},"resolution":{"description":"Temporal resolution of the time series.","enum":["quarter_hourly","hourly","daily","weekly","monthly","yearly"],"examples":["quarter_hourly"],"title":"Resolution","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].resolution","typeLabel":"enum\u003cstring>"},"unit":{"description":"Unit of the time series values.","enum":["A","kV","kW","kWh","hours","SEK","NOK","EUR","SEK_per_kWh","SEK_per_kW","NOK_per_kWh","NOK_per_kW","EUR_per_kWh","EUR_per_kW","%"],"examples":["A"],"title":"Unit","type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].unit","typeLabel":"enum\u003cstring>"},"values":{"description":"Ordered values aligned to the implicit timestamp grid. Uses null for absent values.","items":{"oneOf":[{"type":"number","uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].values.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].values.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].values.items.[INDEX]","typeLabel":"number | null"},"title":"Values","type":"array","isRequired":true,"uniqueKey":"components.items.[INDEX].time_series.items.[INDEX].values","typeLabel":"(number | null)[]"}},"required":["name","resolution","unit","values"],"title":"CalculatedTimeSeries","type":"object","uniqueKey":"components.items.[INDEX].time_series.items.[INDEX]","typeLabel":"CalculatedTimeSeries · object"},"title":"Time Series","type":"array","isRequired":true,"uniqueKey":"components.items.[INDEX].time_series","typeLabel":"CalculatedTimeSeries · object[]"}},"required":["end_time","name","start_time","time_series"],"title":"CalculateComponentResult","type":"object","uniqueKey":"components.items.[INDEX]","typeLabel":"CalculateComponentResult · object"},"title":"Components","type":"array","isRequired":true,"uniqueKey":"components","typeLabel":"CalculateComponentResult · object[]"}},"required":["components"],"title":"CalculateTariffResponse","type":"object","uniqueKey":"","typeLabel":"CalculateTariffResponse · object"},"examples":{"Example":{"title":"Example","value":{"components":[{"end_time":"2026-01-01T00:30:00+01:00","name":"Energiskatt","start_time":"2026-01-01T00:00:00+01:00","time_series":[{"name":"cost","resolution":"quarter_hourly","unit":"SEK","values":[0.54,0.432]}]}]}}},"exampleType":"generated"}},"description":"Successful Response","exampleType":"generated"},"2ef9da09-08ec-401f-a8fc-a62cd322314a":{"description":"The request is well-formed but cannot be fulfilled.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"737fd124-8065-487c-b8c6-506e3ac6ed73":{"description":"A referenced resource was not found.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"97718b09-dd0e-4f3f-9c5f-ff4b7b5e9572":{"description":"The request body failed schema validation.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"97dd253d-026b-47d1-8ac4-7d4d04c3064e":{"apiKeyAuth":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"2219c5a9-9f66-4c8c-9e40-d681b2196046":{"url":"https://api.engrate.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"engrate","siteName":"Engrate Developer Documentation","title":"Calculate Tariff - Engrate Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T14:23:57.200Z","originalFileLocation":"api-reference/calculate-tariff.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=\"Calculate costs for a Tariff. Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Engrate Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_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/engrate/z3Ru6D-2hQC1EDPe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Calculate Tariff - Engrate Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Calculate costs for a Tariff. Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Engrate Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.engrate.io/api-reference/calculate-tariff\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://engrate.mintlify.app/_mintlify/api/og/v2?division=Tariffs\u0026amp;title=Calculate+Tariff\u0026amp;description=Calculate+costs+for+a+%5BTariff%5D%28%2Fapi-reference%2Fcost-of-energy%2Fmodels%2Ftariff%29.%0A%0AExecutes+the+calculation+pipeline+for+each+tariff+component+that+is+active+within+\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=d4efb06ed1e91a49edc8c8cff3d20ced4b03eec42ccc6fbad578d84784c876ea\">\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=\"Calculate Tariff - Engrate Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Calculate costs for a Tariff. Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://engrate.mintlify.app/_mintlify/api/og/v2?division=Tariffs\u0026amp;title=Calculate+Tariff\u0026amp;description=Calculate+costs+for+a+%5BTariff%5D%28%2Fapi-reference%2Fcost-of-energy%2Fmodels%2Ftariff%29.%0A%0AExecutes+the+calculation+pipeline+for+each+tariff+component+that+is+active+within+\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=d4efb06ed1e91a49edc8c8cff3d20ced4b03eec42ccc6fbad578d84784c876ea\">\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/engrate/z3Ru6D-2hQC1EDPe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Engrate Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FFBB00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.engrate.io/api-reference/calculate-tariff\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/calculate-tariff.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.engrate.io/#organization\",\"name\":\"Engrate Developer Documentation\",\"url\":\"https://docs.engrate.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/engrate/zV_tsIFvjMafIhqO/images/logo-light.svg?fit=max\u0026auto=format\u0026n=zV_tsIFvjMafIhqO\u0026q=85\u0026s=0a166849b56cc0dbfbb1584afda2d0ba\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.engrate.io#website\",\"name\":\"Engrate Developer Documentation\",\"url\":\"https://docs.engrate.io\",\"publisher\":{\"@id\":\"https://docs.engrate.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.engrate.io/api-reference/calculate-tariff#webpage\",\"url\":\"https://docs.engrate.io/api-reference/calculate-tariff\",\"name\":\"Calculate Tariff\",\"description\":\"Calculate costs for a Tariff. Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.\",\"dateModified\":\"2026-11-03T14:23:57.200Z\",\"isPartOf\":{\"@id\":\"https://docs.engrate.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.engrate.io/api-reference/calculate-tariff#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.engrate.io/api-reference/calculate-tariff#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cost of Energy\",\"item\":\"https://docs.engrate.io/api-reference/cost-of-energy/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tariffs\",\"item\":\"https://docs.engrate.io/api-reference/cost-of-energy/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Calculate Tariff\",\"item\":\"https://docs.engrate.io/api-reference/calculate-tariff\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.engrate.io/api-reference/calculate-tariff#apireference\",\"headline\":\"Calculate Tariff\",\"name\":\"Calculate Tariff\",\"description\":\"Calculate costs for a Tariff. Executes the calculation pipeline for each tariff component that is active within the requested period. The caller must supply data for every dataset required by the active components, either as inline time_series, persisted profiles, or a combination of both. Dataset names must not overlap between the two inputs.\",\"url\":\"https://docs.engrate.io/api-reference/calculate-tariff\",\"mainEntityOfPage\":{\"@id\":\"https://docs.engrate.io/api-reference/calculate-tariff#webpage\"},\"dateModified\":\"2026-11-03T14:23:57.200Z\",\"publisher\":{\"@id\":\"https://docs.engrate.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.engrate.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Engrate Developer Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Engrate Developer Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/guides/welcome"}]},{"tab":"API reference","groups":[{"group":"Market Communication","pages":[{"title":"Market Communication API","sidebarTitle":"Overview","href":"/api-reference/market-communication/overview"},{"group":"Schedules","pages":[{"group":"Models","icon":"cube","pages":[{"title":"Schedule","href":"/api-reference/schedule-management/models/schedule"},{"title":"Schedule Version","href":"/api-reference/schedule-management/models/schedule-version"},{"title":"Schedule Series","href":"/api-reference/schedule-management/models/schedule-series"},{"title":"Audit Log","href":"/api-reference/schedule-management/models/audit-log"},{"title":"Exchange Priority","href":"/api-reference/schedule-management/models/exchange-priority"}]},{"title":"List Schedules","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create Schedule","deprecated":null,"version":null,"openapi":"/openapi.json post /schedule-management/v1/schedules","href":"/api-reference/schedules/create-schedule"},{"title":"Get Schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}","href":"/api-reference/schedules/get-schedule"},{"title":"List Schedule Versions","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/versions","href":"/api-reference/schedules/list-schedule-versions"},{"title":"Get Schedule Series","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedule-series/{version_uid}","href":"/api-reference/schedules/get-schedule-series"},{"title":"Get Series State","deprecated":null,"version":null,"tag":"ALPHA","openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/series-state","href":"/api-reference/schedules/get-series-state"},{"title":"List Schedule Match Reports","deprecated":null,"version":null,"tag":"ALPHA","openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/reports","href":"/api-reference/schedules/list-schedule-match-reports"},{"title":"List Match Reports","deprecated":null,"version":null,"tag":"ALPHA","openapi":"/openapi.json get /schedule-management/v1/schedule-versions/{version_uid}/reports","href":"/api-reference/schedules/list-match-reports"},{"title":"List Incoming Messages","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/incoming-messages","href":"/api-reference/schedules/list-incoming-messages"},{"title":"Get Incoming Message","deprecated":null,"version":null,"tag":"ALPHA","openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/incoming-messages/{message_uid}","href":"/api-reference/schedules/get-incoming-message"},{"title":"List Audit Logs","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/audit-logs","href":"/api-reference/audit-logs/list-audit-logs"},{"title":"Send Status Request","deprecated":null,"version":null,"openapi":"/openapi.json post /schedule-management/v1/send_status_request","href":"/api-reference/status-request/send-status-request"}]},{"group":"Confirmations","pages":[{"title":"Confirmations API Overview","tag":"ALPHA","href":"/api-reference/confirmations/overview"},{"title":"List Confirmed Schedules","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/confirmed-schedules","href":"/api-reference/timeseries/list-confirmed-schedules"},{"title":"List Confirmed Schedule Series","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/series/confirmed-schedules","href":"/api-reference/timeseries/list-confirmed-schedule-series"}]},{"group":"Allocations","pages":[{"title":"Allocations API Overview","tag":"ALPHA","href":"/api-reference/allocations/overview"},{"group":"Models","icon":"cube","pages":[{"title":"Allocation record","href":"/api-reference/allocations/models/allocation-record"},{"title":"Allocation quality","href":"/api-reference/allocations/models/allocation-quality"},{"title":"Allocation series","href":"/api-reference/allocations/models/allocation-series-item"},{"title":"Aggregate allocation record","href":"/api-reference/allocations/models/aggregate-allocation-record"},{"title":"Aggregate allocation","href":"/api-reference/allocations/models/aggregate-allocation"},{"title":"Finality","href":"/api-reference/allocations/models/finality"},{"title":"Aggregator role","href":"/api-reference/allocations/models/aggregator-role"},{"title":"Allocation basis","href":"/api-reference/allocations/models/allocation-basis"}]},{"title":"List Allocations","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/allocations","href":"/api-reference/timeseries/list-allocations"},{"title":"List Allocation Series","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/series/allocations","href":"/api-reference/timeseries/list-allocation-series"},{"title":"List Aggregate Allocations","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/aggregate-allocations","href":"/api-reference/timeseries/list-aggregate-allocations"},{"title":"List Aggregate Allocation Series","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/series/aggregate-allocations","href":"/api-reference/timeseries/list-aggregate-allocation-series"}]},{"group":"Imbalances","pages":[{"title":"Imbalances API Overview","tag":"ALPHA","href":"/api-reference/imbalances/overview"},{"group":"Models","icon":"cube","pages":[{"title":"Imbalance record","href":"/api-reference/imbalances/models/imbalance-record"},{"title":"Imbalance series","href":"/api-reference/imbalances/models/imbalance-series"}]},{"title":"List Imbalances","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/imbalance","href":"/api-reference/timeseries/list-imbalances"},{"title":"List Imbalance Series","deprecated":null,"version":null,"openapi":"/openapi.json get /market-access/v1alpha1/timeseries/series/imbalance","href":"/api-reference/timeseries/list-imbalance-series"}]},{"group":"Reference data","pages":[{"title":"List Exchange Priority Balance Groups","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/reference/exchange-priority-balance-groups","href":"/api-reference/reference/list-exchange-priority-balance-groups"},{"title":"Check Exchange Priority","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/reference/exchange-priority-check/{eic_code}","href":"/api-reference/reference/check-exchange-priority"}]}]},{"group":"Portfolio Forecasts","pages":[{"group":"Submissions","pages":[{"title":"Portfolio Forecasts API Overview","tag":"ALPHA","href":"/api-reference/portfolio-forecasts/overview"},{"title":"Submit portfolio forecast","deprecated":null,"version":null,"openapi":"/portfolio-forecasts-openapi.json post /portfolio-forecasts/v1alpha1/submissions","href":"/api-reference/submit-portfolio-forecast"},{"title":"List stored delivery days","deprecated":null,"version":null,"openapi":"/portfolio-forecasts-openapi.json get /portfolio-forecasts/v1alpha1/submissions","href":"/api-reference/list-stored-delivery-days"},{"title":"Read back stored forecast","deprecated":null,"version":null,"openapi":"/portfolio-forecasts-openapi.json get /portfolio-forecasts/v1alpha1/submissions/{delivery_day}","href":"/api-reference/read-back-stored-forecast"}]}]},{"group":"Core","pages":[{"group":"Market reference data","pages":[{"title":"Core API Overview","href":"/api-reference/core/overview"},{"group":"Models","icon":"cube","pages":[{"title":"Party","href":"/api-reference/core/models/party"},{"title":"Bidding Zone","href":"/api-reference/core/models/bidding-zone"},{"title":"Scheduling Area","href":"/api-reference/core/models/scheduling-area"},{"title":"Control Area","href":"/api-reference/core/models/control-area"},{"title":"Metering Grid Area","href":"/api-reference/core/models/metering-grid-area"},{"title":"Metering Point","href":"/api-reference/core/models/metering-point"},{"title":"Accounting Point","href":"/api-reference/core/models/accounting-point"},{"title":"Meter","href":"/api-reference/core/models/meter"},{"title":"Register","href":"/api-reference/core/models/register"},{"title":"Resource","href":"/api-reference/core/models/resource"},{"title":"Extra Identifier","href":"/api-reference/core/models/extra-identifier"}]},{"title":"List Parties","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/parties","href":"/api-reference/list-parties"},{"title":"List Bidding Zones","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/bidding-zones","href":"/api-reference/list-bidding-zones"},{"title":"List Scheduling Areas","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/scheduling-areas","href":"/api-reference/list-scheduling-areas"},{"title":"List Control Areas","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/control-areas","href":"/api-reference/list-control-areas"},{"title":"List Metering Grid Areas","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/metering-grid-areas","href":"/api-reference/list-metering-grid-areas"},{"title":"Get Geodata","deprecated":null,"version":null,"openapi":"/openapi.json get /core/v1/geo","href":"/api-reference/geo/get-geodata"},{"title":"List holidays","openapi":"GET /core/v1/holidays","href":"/api-reference/core/holidays"}]}]},{"group":"Cost of Energy","pages":[{"group":"Tariffs","pages":[{"title":"Cost of Energy API Overview","href":"/api-reference/cost-of-energy/overview"},{"title":"Python SDK","tag":"BETA","href":"/api-reference/cost-of-energy/engratepy"},{"title":"Calculation Pipeline","href":"/api-reference/cost-of-energy/calculation-pipeline"},{"title":"In Optimisation","href":"/api-reference/cost-of-energy/optimisation"},{"group":"Models","icon":"cube","pages":[{"title":"Tariff","href":"/api-reference/cost-of-energy/models/tariff"},{"title":"Tariff Component","href":"/api-reference/cost-of-energy/models/tariff-component"},{"title":"Dataset","href":"/api-reference/cost-of-energy/models/dataset"},{"title":"Unit","href":"/api-reference/cost-of-energy/models/unit"},{"title":"Level","href":"/api-reference/cost-of-energy/models/level"},{"title":"Periodic Amount","href":"/api-reference/cost-of-energy/models/periodic-amount"},{"title":"Resolution","href":"/api-reference/cost-of-energy/models/resolution"}]},{"group":"Functions","icon":"cube","pages":[{"title":"Function","href":"/api-reference/cost-of-energy/functions/overview"},{"title":"Function: Constant","href":"/api-reference/cost-of-energy/functions/constant"},{"title":"Function: Add","href":"/api-reference/cost-of-energy/functions/add"},{"title":"Function: Subtract","href":"/api-reference/cost-of-energy/functions/subtract"},{"title":"Function: Divide","href":"/api-reference/cost-of-energy/functions/divide"},{"title":"Function: Multiply","href":"/api-reference/cost-of-energy/functions/multiply"},{"title":"Function: Aggregate","href":"/api-reference/cost-of-energy/functions/aggregate"},{"title":"Function: Resample","href":"/api-reference/cost-of-energy/functions/resample"},{"title":"Function: Select","href":"/api-reference/cost-of-energy/functions/select"},{"title":"Function: Mask","href":"/api-reference/cost-of-energy/functions/mask"},{"title":"Function: Clip","href":"/api-reference/cost-of-energy/functions/clip"},{"title":"Function: Lookup","href":"/api-reference/cost-of-energy/functions/lookup"}]},{"group":"Conditions","icon":"cube","pages":[{"title":"Conditions","href":"/api-reference/cost-of-energy/conditions/overview"},{"title":"Condition: Month","href":"/api-reference/cost-of-energy/conditions/month"},{"title":"Condition: DayOfWeek","href":"/api-reference/cost-of-energy/conditions/day-of-week"},{"title":"Condition: TimeOfDay","href":"/api-reference/cost-of-energy/conditions/time-of-day"},{"title":"Condition: ExcludeHolidays","href":"/api-reference/cost-of-energy/conditions/exclude-holidays"},{"title":"Condition: And","href":"/api-reference/cost-of-energy/conditions/and"},{"title":"Condition: Or","href":"/api-reference/cost-of-energy/conditions/or"},{"title":"Condition: Not","href":"/api-reference/cost-of-energy/conditions/not"},{"title":"Condition: Highest","href":"/api-reference/cost-of-energy/conditions/highest"},{"title":"Condition: Lowest","href":"/api-reference/cost-of-energy/conditions/lowest"}]},{"title":"List profiles","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/profiles","href":"/api-reference/profiles/list-profiles"},{"title":"Get a profile","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/profiles/{profile_id}","href":"/api-reference/profiles/get-a-profile"},{"title":"Create a profile","deprecated":null,"version":null,"openapi":"/openapi.json post /cost-of-energy/v1/profiles","href":"/api-reference/profiles/create-a-profile"},{"title":"Update a profile","deprecated":null,"version":null,"openapi":"/openapi.json put /cost-of-energy/v1/profiles/{profile_id}","href":"/api-reference/profiles/update-a-profile"},{"title":"Delete a profile","deprecated":null,"version":null,"openapi":"/openapi.json delete /cost-of-energy/v1/profiles/{profile_id}","href":"/api-reference/profiles/delete-a-profile"},{"title":"List Datasets","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/datasets","href":"/api-reference/list-datasets"},{"title":"List Tariffs","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/tariffs","href":"/api-reference/list-tariffs"},{"title":"Get Tariff","description":"Get a single [Tariff](/api-reference/cost-of-energy/models/tariff) by ID.","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/tariffs/{tariff_id}","href":"/api-reference/get-tariff"},{"title":"Calculate Tariff","deprecated":null,"version":null,"openapi":"/openapi.json post /cost-of-energy/v1/calculate","href":"/api-reference/calculate-tariff"},{"title":"Get Simplified Tariff","openapi":"GET /cost-of-energy/v1/tariffs/{tariff_id}/simplified","description":"Get a simplified, indicative view of a [Tariff](/api-reference/cost-of-energy/models/tariff)'s rates over a time range.\n\nThe response is a set of rate timeseries, one per (input dataset, rate unit). In each interval, `rate` is what is paid per kWh of energy on the input (for per-kWh series) or per kW of power peak derived from the input (for per-kW series), in the series' own currency.\n\nThis is an approximation of the tariff's price shape, meant for heuristics that need a coarse \"when is energy cheap/expensive\" signal — not for exact cost calculation or optimisation.\n\nComponents that don't fit a simple per-kWh or per-kW rate (fixed fees, spot-price-linked charges, overdraft fees …) are surfaced by name and applicability window in `unprojectable_components` rather than appearing in the rate timeseries.\n\nUse [Calculate Tariff](/api-reference/calculate-tariff) for exact cost calculation, or [In Optimisation](/api-reference/cost-of-energy/optimisation) for using tariffs in optimisation models.","href":"/api-reference/cost-of-energy/get-simplified-tariff"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"basePath":"","title":"Calculate Tariff - Engrate Developer Documentation","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}