Get a simplified, indicative view of a Tariff’s rates over a time range.
The 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.
This 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.
Components 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.
Summed rate timeseries per (dataset_id, unit) group, across all projectable components contributing to that group. Empty if the tariff has no projectable components.
Tariff components present on the tariff that could not be projected onto a rate timeseries. Listed by name and applicability window only; see Get Tariff for full component definitions.
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":"6ae347ee9757c0f6dff41199","collectionId":"05f2aa75-8ebe-4269-aae8-7fe51406186a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae347ee9757c0f6dff41199"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae347ee9757c0f6dff41199","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API reference","count":99},{"language":"default","tag":"Market Communication","count":48},{"language":"default","tag":"Cost of Energy","count":43},{"language":"default","tag":"Models","count":31},{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"Core","count":19},{"language":"default","tag":"Schedules","count":17},{"language":"default","tag":"Allocations","count":15},{"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"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/cost-of-energy/get-simplified-tariff","slug":"/api-reference/cost-of-energy/get-simplified-tariff","pageMetadata":{"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"},"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: [\"Get a simplified, indicative view of a \", _jsx(_components.a, {\n href: \"/api-reference/cost-of-energy/models/tariff\",\n children: \"Tariff\"\n }), \"’s rates over a time range.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The response is a set of rate timeseries, one per (input dataset, rate unit). In each interval, \", _jsx(_components.code, {\n children: \"rate\"\n }), \" 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 }), \"\\n\", _jsx(_components.p, {\n children: \"This 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 }), \"\\n\", _jsxs(_components.p, {\n children: [\"Components 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 \", _jsx(_components.code, {\n children: \"unprojectable_components\"\n }), \" rather than appearing in the rate timeseries.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Use \", _jsx(_components.a, {\n href: \"/api-reference/calculate-tariff\",\n children: \"Calculate Tariff\"\n }), \" for exact cost calculation, or \", _jsx(_components.a, {\n href: \"/api-reference/cost-of-energy/optimisation\",\n children: \"In Optimisation\"\n }), \" for using tariffs in optimisation models.\"]\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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"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.","operationId":"get_simplified_tariff_cost_of_energy_v1_tariffs__tariff_id__simplified_get","parameters":["495d97f0-717f-4007-93fb-975bebdeced0","714de194-7a7a-4639-a2ef-ab033eb4fcfe","55960a6c-74a4-4c04-9450-a26de4bf48e9"],"responses":{"200":"23f4a98e-f97e-4f08-b64a-d0c047837bbb","422":"9b2cbc3c-ef5f-4b0e-922a-144c787f3020"},"summary":"Get Simplified Tariff","method":"get","type":"path","servers":["78eef4c3-21ea-4b0f-a322-eb5a5497186f"],"security":["f87a70a6-fb50-44d2-80a2-6d402e241f7c"],"path":"/cost-of-energy/v1/tariffs/{tariff_id}/simplified","baseUrlOptions":["https://api.engrate.io"],"title":"Get Simplified Tariff","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"495d97f0-717f-4007-93fb-975bebdeced0":{"in":"path","name":"tariff_id","required":true,"schema":{"format":"uuid","title":"Tariff Id","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"714de194-7a7a-4639-a2ef-ab033eb4fcfe":{"description":"ISO 8601 timezone-aware datetime at which the range begins (inclusive).","in":"query","name":"start_time","required":true,"schema":{"description":"ISO 8601 timezone-aware datetime at which the range begins (inclusive).","format":"date-time","title":"Start Time","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"55960a6c-74a4-4c04-9450-a26de4bf48e9":{"description":"ISO 8601 timezone-aware datetime at which the range ends (exclusive). Must be strictly greater than `start_time`.","in":"query","name":"end_time","required":true,"schema":{"description":"ISO 8601 timezone-aware datetime at which the range ends (exclusive). Must be strictly greater than `start_time`.","format":"date-time","title":"End Time","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate-time>"}}},"responses":{"23f4a98e-f97e-4f08-b64a-d0c047837bbb":{"content":{"application/json":{"schema":{"description":"Indicative, simplified view of a [Tariff](/api-reference/cost-of-energy/models/tariff)'s rates over a time range.","example":{"component_rates":[{"component":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Energiskatt"},"rate":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-02T00:00:00Z","rate":0.36,"start_time":"2026-01-01T00:00:00Z"}],"unit":"SEK_per_kWh"}},{"component":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Effektavgift"},"rate":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"}}],"dataset_rates":[{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-02T00:00:00Z","rate":0.56,"start_time":"2026-01-01T00:00:00Z"}],"unit":"SEK_per_kWh"},{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"}],"unprojectable_components":[{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Abonnemangsavgift"}]},"properties":{"component_rates":{"description":"Per-component rate timeseries, for components that can be projected onto a per-kWh or per-kW rate. Empty if the tariff has no projectable components.","items":{"description":"A single tariff component's projected rate timeseries.","example":{"component":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Energiskatt"},"rate":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2027-01-01T00:00:00Z","rate":0.36,"start_time":"2026-01-01T00:00:00Z"}],"unit":"SEK_per_kWh"}},"properties":{"component":{"description":"Identifying fields of the component this rate timeseries belongs to.","example":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Energiskatt"},"properties":{"name":{"description":"Name of the tariff component as given by the issuing [Party](/api-reference/core/models/party).","examples":["Energiskatt","Överföringsavgift","Effektavgift","Abonnemangsavgift","Nätnytta","Överuttagsavgift"],"title":"Name","type":"string","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].component.name","typeLabel":"string"},"applicable_from":{"oneOf":[{"type":"string","title":"Applicable From","description":"ISO 8601 formatted datetime from when the tariff component becomes applicable, if any. If `null` or not included, applicable immediately.","format":"date-time","example":"2026-01-01T00:00:00+01:00","uniqueKey":"component_rates.items.[INDEX].component.applicable_from.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Applicable From","description":"ISO 8601 formatted datetime from when the tariff component becomes applicable, if any. If `null` or not included, applicable immediately.","example":"2026-01-01T00:00:00+01:00","uniqueKey":"component_rates.items.[INDEX].component.applicable_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"component_rates.items.[INDEX].component.applicable_from","typeLabel":"string\u003cdate-time> | null"},"applicable_to":{"oneOf":[{"type":"string","title":"Applicable To","description":"ISO 8601 formatted datetime at which the tariff component ceases to be applicable (exclusive — the component does not apply at this instant). If `null` or not included, applicable until further notice.","format":"date-time","example":"2027-01-01T00:00:00+01:00","uniqueKey":"component_rates.items.[INDEX].component.applicable_to.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Applicable To","description":"ISO 8601 formatted datetime at which the tariff component ceases to be applicable (exclusive — the component does not apply at this instant). If `null` or not included, applicable until further notice.","example":"2027-01-01T00:00:00+01:00","uniqueKey":"component_rates.items.[INDEX].component.applicable_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"component_rates.items.[INDEX].component.applicable_to","typeLabel":"string\u003cdate-time> | null"}},"required":["name"],"title":"ComponentIdentity","type":"object","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].component","typeLabel":"ComponentIdentity · object"},"rate":{"description":"The component's projected rate timeseries.","example":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"},"properties":{"dataset_id":{"description":"Identifier of the [Dataset](/api-reference/cost-of-energy/models/dataset) this timeseries' rates apply to.","examples":["quarter-hourly-energy-offtake","quarter-hourly-energy-injection"],"title":"Dataset Id","type":"string","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.dataset_id","typeLabel":"string"},"intervals":{"description":"Chronologically ordered, non-overlapping flat-rate intervals covering the requested range exactly.","items":{"description":"A flat-rate slice of a Rate Timeseries, spanning the half-open UTC range `[start_time, end_time)`.","example":{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},"properties":{"end_time":{"description":"ISO 8601 formatted UTC datetime at which this interval ends (exclusive).","examples":["2026-01-01T22:00:00Z"],"format":"date-time","title":"End Time","type":"string","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.intervals.items.[INDEX].end_time","typeLabel":"string\u003cdate-time>"},"rate":{"description":"Flat rate that applies across this interval, expressed in the parent timeseries' unit.","title":"Rate","type":"number","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.intervals.items.[INDEX].rate","typeLabel":"number"},"start_time":{"description":"ISO 8601 formatted UTC datetime at which this interval begins (inclusive).","examples":["2026-01-01T06:00:00Z"],"format":"date-time","title":"Start Time","type":"string","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.intervals.items.[INDEX].start_time","typeLabel":"string\u003cdate-time>"}},"required":["end_time","rate","start_time"],"title":"RateInterval","type":"object","uniqueKey":"component_rates.items.[INDEX].rate.intervals.items.[INDEX]","typeLabel":"RateInterval · object"},"title":"Intervals","type":"array","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.intervals","typeLabel":"RateInterval · object[]"},"unit":{"oneOf":[{"type":"string","title":"Unit","description":"Unit of the rates in this timeseries — a monetary rate per energy (`SEK_per_kWh`, `NOK_per_kWh`, `EUR_per_kWh`) or per power (`SEK_per_kW`, `NOK_per_kW`, `EUR_per_kW`).","enum":["SEK_per_kWh","NOK_per_kWh","EUR_per_kWh"],"isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","title":"Unit","description":"Unit of the rates in this timeseries — a monetary rate per energy (`SEK_per_kWh`, `NOK_per_kWh`, `EUR_per_kWh`) or per power (`SEK_per_kW`, `NOK_per_kW`, `EUR_per_kW`).","enum":["SEK_per_kW","NOK_per_kW","EUR_per_kW"],"isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.unit.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate.unit","typeLabel":"enum\u003cstring>"}},"required":["dataset_id","intervals","unit"],"title":"RateTimeseries","type":"object","isRequired":true,"uniqueKey":"component_rates.items.[INDEX].rate","typeLabel":"RateTimeseries · object"}},"required":["component","rate"],"title":"ComponentRate","type":"object","uniqueKey":"component_rates.items.[INDEX]","typeLabel":"ComponentRate · object"},"title":"Component Rates","type":"array","isRequired":true,"uniqueKey":"component_rates","typeLabel":"ComponentRate · object[]"},"dataset_rates":{"description":"Summed rate timeseries per `(dataset_id, unit)` group, across all projectable components contributing to that group. Empty if the tariff has no projectable components.","items":{"description":"A single rate timeseries for one input dataset and unit, made up of chronologically ordered, non-overlapping flat-rate Rate Intervals.","example":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"},"properties":{"dataset_id":{"description":"Identifier of the [Dataset](/api-reference/cost-of-energy/models/dataset) this timeseries' rates apply to.","examples":["quarter-hourly-energy-offtake","quarter-hourly-energy-injection"],"title":"Dataset Id","type":"string","isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].dataset_id","typeLabel":"string"},"intervals":{"description":"Chronologically ordered, non-overlapping flat-rate intervals covering the requested range exactly.","items":{"description":"A flat-rate slice of a Rate Timeseries, spanning the half-open UTC range `[start_time, end_time)`.","example":{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},"properties":{"end_time":{"description":"ISO 8601 formatted UTC datetime at which this interval ends (exclusive).","examples":["2026-01-01T22:00:00Z"],"format":"date-time","title":"End Time","type":"string","isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].intervals.items.[INDEX].end_time","typeLabel":"string\u003cdate-time>"},"rate":{"description":"Flat rate that applies across this interval, expressed in the parent timeseries' unit.","title":"Rate","type":"number","isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].intervals.items.[INDEX].rate","typeLabel":"number"},"start_time":{"description":"ISO 8601 formatted UTC datetime at which this interval begins (inclusive).","examples":["2026-01-01T06:00:00Z"],"format":"date-time","title":"Start Time","type":"string","isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].intervals.items.[INDEX].start_time","typeLabel":"string\u003cdate-time>"}},"required":["end_time","rate","start_time"],"title":"RateInterval","type":"object","uniqueKey":"dataset_rates.items.[INDEX].intervals.items.[INDEX]","typeLabel":"RateInterval · object"},"title":"Intervals","type":"array","isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].intervals","typeLabel":"RateInterval · object[]"},"unit":{"oneOf":[{"type":"string","title":"Unit","description":"Unit of the rates in this timeseries — a monetary rate per energy (`SEK_per_kWh`, `NOK_per_kWh`, `EUR_per_kWh`) or per power (`SEK_per_kW`, `NOK_per_kW`, `EUR_per_kW`).","enum":["SEK_per_kWh","NOK_per_kWh","EUR_per_kWh"],"isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].unit.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","title":"Unit","description":"Unit of the rates in this timeseries — a monetary rate per energy (`SEK_per_kWh`, `NOK_per_kWh`, `EUR_per_kWh`) or per power (`SEK_per_kW`, `NOK_per_kW`, `EUR_per_kW`).","enum":["SEK_per_kW","NOK_per_kW","EUR_per_kW"],"isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].unit.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"dataset_rates.items.[INDEX].unit","typeLabel":"enum\u003cstring>"}},"required":["dataset_id","intervals","unit"],"title":"RateTimeseries","type":"object","uniqueKey":"dataset_rates.items.[INDEX]","typeLabel":"RateTimeseries · object"},"title":"Dataset Rates","type":"array","isRequired":true,"uniqueKey":"dataset_rates","typeLabel":"RateTimeseries · object[]"},"unprojectable_components":{"description":"Tariff components present on the tariff that could not be projected onto a rate timeseries. Listed by name and applicability window only; see [Get Tariff](/api-reference/cost-of-energy/get-tariff) for full component definitions.","items":{"description":"Identifies a tariff component by its issuing-party name and applicability window. See [Tariff Component](/api-reference/cost-of-energy/models/tariff-component) for the full definition.","example":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Energiskatt"},"properties":{"name":{"description":"Name of the tariff component as given by the issuing [Party](/api-reference/core/models/party).","examples":["Energiskatt","Överföringsavgift","Effektavgift","Abonnemangsavgift","Nätnytta","Överuttagsavgift"],"title":"Name","type":"string","isRequired":true,"uniqueKey":"unprojectable_components.items.[INDEX].name","typeLabel":"string"},"applicable_from":{"oneOf":[{"type":"string","title":"Applicable From","description":"ISO 8601 formatted datetime from when the tariff component becomes applicable, if any. If `null` or not included, applicable immediately.","format":"date-time","example":"2026-01-01T00:00:00+01:00","uniqueKey":"unprojectable_components.items.[INDEX].applicable_from.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Applicable From","description":"ISO 8601 formatted datetime from when the tariff component becomes applicable, if any. If `null` or not included, applicable immediately.","example":"2026-01-01T00:00:00+01:00","uniqueKey":"unprojectable_components.items.[INDEX].applicable_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"unprojectable_components.items.[INDEX].applicable_from","typeLabel":"string\u003cdate-time> | null"},"applicable_to":{"oneOf":[{"type":"string","title":"Applicable To","description":"ISO 8601 formatted datetime at which the tariff component ceases to be applicable (exclusive — the component does not apply at this instant). If `null` or not included, applicable until further notice.","format":"date-time","example":"2027-01-01T00:00:00+01:00","uniqueKey":"unprojectable_components.items.[INDEX].applicable_to.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Applicable To","description":"ISO 8601 formatted datetime at which the tariff component ceases to be applicable (exclusive — the component does not apply at this instant). If `null` or not included, applicable until further notice.","example":"2027-01-01T00:00:00+01:00","uniqueKey":"unprojectable_components.items.[INDEX].applicable_to.oneOf.1","typeLabel":"null"}],"uniqueKey":"unprojectable_components.items.[INDEX].applicable_to","typeLabel":"string\u003cdate-time> | null"}},"required":["name"],"title":"ComponentIdentity","type":"object","uniqueKey":"unprojectable_components.items.[INDEX]","typeLabel":"ComponentIdentity · object"},"title":"Unprojectable Components","type":"array","isRequired":true,"uniqueKey":"unprojectable_components","typeLabel":"ComponentIdentity · object[]"}},"required":["component_rates","dataset_rates","unprojectable_components"],"title":"SimplifiedTariffResponse","type":"object","uniqueKey":"","typeLabel":"SimplifiedTariffResponse · object"},"examples":{"Example":{"title":"Example","value":{"component_rates":[{"component":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Energiskatt"},"rate":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-02T00:00:00Z","rate":0.36,"start_time":"2026-01-01T00:00:00Z"}],"unit":"SEK_per_kWh"}},{"component":{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Effektavgift"},"rate":{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"}}],"dataset_rates":[{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-02T00:00:00Z","rate":0.56,"start_time":"2026-01-01T00:00:00Z"}],"unit":"SEK_per_kWh"},{"dataset_id":"quarter-hourly-energy-offtake","intervals":[{"end_time":"2026-01-01T06:00:00Z","rate":0,"start_time":"2026-01-01T00:00:00Z"},{"end_time":"2026-01-01T22:00:00Z","rate":50,"start_time":"2026-01-01T06:00:00Z"},{"end_time":"2026-01-02T00:00:00Z","rate":0,"start_time":"2026-01-01T22:00:00Z"}],"unit":"SEK_per_kW"}],"unprojectable_components":[{"applicable_from":"2026-01-01T00:00:00+01:00","name":"Abonnemangsavgift"}]}}},"exampleType":"generated"}},"description":"Successful Response","exampleType":"generated"},"9b2cbc3c-ef5f-4b0e-922a-144c787f3020":{"content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"title":"Location","type":"array","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"title":"Error Type","type":"string","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"ctx":{"title":"Context","type":"object","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"title":"Detail","type":"array","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"title":"HTTPValidationError","type":"object","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","ctx":{},"input":"\u003cunknown>"}]}}},"exampleType":"generated"}},"description":"Validation Error","exampleType":"generated"}},"security":{"f87a70a6-fb50-44d2-80a2-6d402e241f7c":{"apiKeyAuth":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"78eef4c3-21ea-4b0f-a322-eb5a5497186f":{"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":"Get Simplified Tariff - Engrate Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-03T08:04:46.036Z","originalFileLocation":"api-reference/cost-of-energy/get-simplified-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=\"Get a simplified, indicative view of a Tariff\u0026#x27;s rates over a time range. The 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\u0026#x27; own currency. This is an approximation of the tariff\u0026#x27;s price shape, meant for heuristics that need a coarse \u0026quot;when is energy cheap/expensive\u0026quot; signal — not for exact cost calculation or optimisation. Components that don\u0026#x27;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. Use Calculate Tariff for exact cost calculation, or In Optimisation for using tariffs in optimisation models.\">\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=\"Get Simplified Tariff - Engrate Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a simplified, indicative view of a Tariff\u0026#x27;s rates over a time range. The 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\u0026#x27; own currency. This is an approximation of the tariff\u0026#x27;s price shape, meant for heuristics that need a coarse \u0026quot;when is energy cheap/expensive\u0026quot; signal — not for exact cost calculation or optimisation. Components that don\u0026#x27;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. Use Calculate Tariff for exact cost calculation, or In Optimisation for using tariffs in optimisation models.\">\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/cost-of-energy/get-simplified-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=Cost+of+Energy\u0026amp;title=Get+Simplified+Tariff\u0026amp;description=Get+a+simplified%2C+indicative+view+of+a+%5BTariff%5D%28%2Fapi-reference%2Fcost-of-energy%2Fmodels%2Ftariff%29%27s+rates+over+a+time+range.%0A%0AThe+response+is+a+set+of+rate+timeserie\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=bf2886a2bd91a18e9a821eaaf8eade77ad8cf318ff7c68eb088163ad2b0d6620\">\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=\"Get Simplified Tariff - Engrate Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a simplified, indicative view of a Tariff\u0026#x27;s rates over a time range. The 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\u0026#x27; own currency. This is an approximation of the tariff\u0026#x27;s price shape, meant for heuristics that need a coarse \u0026quot;when is energy cheap/expensive\u0026quot; signal — not for exact cost calculation or optimisation. Components that don\u0026#x27;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. Use Calculate Tariff for exact cost calculation, or In Optimisation for using tariffs in optimisation models.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://engrate.mintlify.app/_mintlify/api/og/v2?division=Cost+of+Energy\u0026amp;title=Get+Simplified+Tariff\u0026amp;description=Get+a+simplified%2C+indicative+view+of+a+%5BTariff%5D%28%2Fapi-reference%2Fcost-of-energy%2Fmodels%2Ftariff%29%27s+rates+over+a+time+range.%0A%0AThe+response+is+a+set+of+rate+timeserie\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=bf2886a2bd91a18e9a821eaaf8eade77ad8cf318ff7c68eb088163ad2b0d6620\">\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/cost-of-energy/get-simplified-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/cost-of-energy/get-simplified-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/cost-of-energy/get-simplified-tariff#webpage\",\"url\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff\",\"name\":\"Get Simplified Tariff\",\"description\":\"Get a simplified, indicative view of a Tariff's rates over a time range. The 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. This 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. Components 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. Use Calculate Tariff for exact cost calculation, or In Optimisation for using tariffs in optimisation models.\",\"dateModified\":\"2026-06-03T08:04:46.036Z\",\"isPartOf\":{\"@id\":\"https://docs.engrate.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-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\":\"Get Simplified Tariff\",\"item\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff#apireference\",\"headline\":\"Get Simplified Tariff\",\"name\":\"Get Simplified Tariff\",\"description\":\"Get a simplified, indicative view of a Tariff's rates over a time range. The 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. This 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. Components 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. Use Calculate Tariff for exact cost calculation, or In Optimisation for using tariffs in optimisation models.\",\"url\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff\",\"mainEntityOfPage\":{\"@id\":\"https://docs.engrate.io/api-reference/cost-of-energy/get-simplified-tariff#webpage\"},\"dateModified\":\"2026-06-03T08:04:46.036Z\",\"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":"Core","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":[{"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","deprecated":null,"version":null,"openapi":"/openapi.json get /cost-of-energy/v1/tariffs/{tariff_id}","href":"/api-reference/get-tariff"},{"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"},{"title":"Get Simplified Tariff","openapi":"GET /cost-of-energy/v1/tariffs/{tariff_id}/simplified","href":"/api-reference/cost-of-energy/get-simplified-tariff"}]},{"group":"Market Communication","pages":[{"title":"Market Communication API","sidebarTitle":"Overview","description":"The endpoints for schedules and allocations, grouped by process.","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":"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":"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":"Portfolio Forecasts","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"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"basePath":"","title":"Get Simplified Tariff - Engrate Developer Documentation","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}