Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.
GET
/
core
/
v1
/
holidays
List Holidays
curl --request GET \ --url https://api.engrate.io/core/v1/holidays \ --header 'Authorization: <api-key>'
{"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":"Sign up","href":"https://console.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":"6adb2c25c702a650395449ba","collectionId":"ea28ac7c-e728-4189-9c88-e293809df7fa","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb2c25c702a650395449ba"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adb2c25c702a650395449ba","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API reference","count":131},{"language":"default","tag":"Cost of Energy","count":43},{"language":"default","tag":"Models","count":40},{"language":"default","tag":"Schedule Management","count":26},{"language":"default","tag":"Settlement Management (MaBiS)","count":26},{"language":"default","tag":"Core","count":19},{"language":"default","tag":"Allocations","count":13},{"language":"default","tag":"Functions","count":12},{"language":"default","tag":"Conditions","count":10},{"language":"default","tag":"Guides","count":10}]},"assistantConfig":{},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":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/core/holidays","slug":"/api-reference/core/holidays","pageMetadata":{"title":"List holidays","openapi":"GET /core/v1/holidays","description":"List public holidays in a range of years.\n\nReturns the holiday occurrences for years in `[start_year, end_year)` (`start_year` inclusive, `end_year` exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. `se/julafton`). Each occurrence carries the IANA timezone in which the holiday is observed.","href":"/api-reference/core/holidays"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List public holidays in a range of years.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns the holiday occurrences for years in \", _jsx(_components.code, {\n children: \"[start_year, end_year)\"\n }), \" (\", _jsx(_components.code, {\n children: \"start_year\"\n }), \" inclusive, \", _jsx(_components.code, {\n children: \"end_year\"\n }), \" exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. \", _jsx(_components.code, {\n children: \"se/julafton\"\n }), \"). Each occurrence carries the IANA timezone in which the holiday is observed.\"]\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`holiday-identifiers`,children:`Holiday identifiers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/forste_nyttarsdag`})}),_jsx(_components.td,{children:`January 1st.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/skjartorsdag`})}),_jsx(_components.td,{children:`The Thursday before Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/langfredag`})}),_jsx(_components.td,{children:`The Friday before Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/forste_paskedag`})}),_jsx(_components.td,{children:`Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/andre_paskedag`})}),_jsx(_components.td,{children:`The Monday after Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/arbeidernes_dag`})}),_jsx(_components.td,{children:`May 1st.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/kristi_himmelfartsdag`})}),_jsx(_components.td,{children:`Ascension Day, the Thursday 39 days after Easter (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/grunnlovsdag`})}),_jsx(_components.td,{children:`May 17th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/forste_pinsedag`})}),_jsx(_components.td,{children:`Whit Sunday / Pentecost (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/andre_pinsedag`})}),_jsx(_components.td,{children:`Whit Monday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/forste_juledag`})}),_jsx(_components.td,{children:`December 25th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`no/andre_juledag`})}),_jsx(_components.td,{children:`December 26th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/nyarsdagen`})}),_jsx(_components.td,{children:`January 1st.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/trettondagsafton`})}),_jsx(_components.td,{children:`January 5th (Epiphany Eve).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/trettondedag_jul`})}),_jsx(_components.td,{children:`January 6th (Epiphany).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/skartorsdagen`})}),_jsx(_components.td,{children:`The Thursday before Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/langfredagen`})}),_jsx(_components.td,{children:`The Friday before Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/paskafton`})}),_jsx(_components.td,{children:`The Saturday before Easter Sunday — Easter Eve (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/paskdagen`})}),_jsx(_components.td,{children:`Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/annandag_pask`})}),_jsx(_components.td,{children:`The Monday after Easter Sunday (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/forsta_maj`})}),_jsx(_components.td,{children:`May 1st.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/kristi_himmelsfard`})}),_jsx(_components.td,{children:`Ascension Day, the Thursday 39 days after Easter (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/pingstafton`})}),_jsx(_components.td,{children:`Whitsun Eve, the Saturday before Pentecost (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/nationaldagen`})}),_jsx(_components.td,{children:`June 6th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/midsommarafton`})}),_jsx(_components.td,{children:`The Friday before Midsummer Day (moveable).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/allhelgonaafton`})}),_jsx(_components.td,{children:`The Friday between October 30th and November 5th — All Saints’ Eve.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/julafton`})}),_jsx(_components.td,{children:`December 24th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/juldagen`})}),_jsx(_components.td,{children:`December 25th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/annandag_jul`})}),_jsx(_components.td,{children:`December 26th.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`se/nyarsafton`})}),_jsx(_components.td,{children:`December 31st.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List holidays","openapi":"GET /core/v1/holidays","description":"List public holidays in a range of years.\n\nReturns the holiday occurrences for years in `[start_year, end_year)` (`start_year` inclusive, `end_year` exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. `se/julafton`). Each occurrence carries the IANA timezone in which the holiday is observed.","href":"/api-reference/core/holidays"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Holiday identifiers","slug":"holiday-identifiers","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"List public holidays in a range of years.\n\nReturns the holiday occurrences for years in `[start_year, end_year)` (`start_year` inclusive, `end_year` exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. `se/julafton`). Each occurrence carries the IANA timezone in which the holiday is observed.","operationId":"list_holidays_core_v1_holidays_get","parameters":["05a4f0d3-9735-4a13-a381-d9fb76a701d1","fcaf4395-097b-4b2d-b95d-67f5c4630a95","e5409931-5331-40e4-ad5a-b7f46a045000","167dd567-0967-46ae-87d9-68646aa82766"],"responses":{"200":"94d4335f-2b1e-4062-ac91-b0bb7ba6e859","422":"4a215c68-00ed-41b4-a906-ab11e86c30b3"},"summary":"List Holidays","tags":["holidays"],"method":"get","type":"path","servers":["e2d0fd42-3318-4d8b-9552-91334ce074b8"],"security":["90649cf1-42fb-4b2d-80f2-b035fab699a5"],"path":"/core/v1/holidays","baseUrlOptions":["https://api.engrate.io"],"title":"List Holidays","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"05a4f0d3-9735-4a13-a381-d9fb76a701d1":{"description":"Start year (inclusive).","in":"query","name":"start_year","required":true,"schema":{"description":"Start year (inclusive).","title":"Start Year","type":"integer","isRequired":true,"uniqueKey":"","typeLabel":"integer"}},"fcaf4395-097b-4b2d-b95d-67f5c4630a95":{"description":"End year (exclusive).","in":"query","name":"end_year","required":true,"schema":{"description":"End year (exclusive).","title":"End Year","type":"integer","isRequired":true,"uniqueKey":"","typeLabel":"integer"}},"e5409931-5331-40e4-ad5a-b7f46a045000":{"description":"ISO 3166-1 alpha-2 country code (lowercase).","in":"query","name":"country","required":false,"schema":{"oneOf":[{"type":"string","title":"Country","description":"ISO 3166-1 alpha-2 country code (lowercase).","maxLength":2,"minLength":2,"example":"se","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Country","description":"ISO 3166-1 alpha-2 country code (lowercase).","example":"se","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"167dd567-0967-46ae-87d9-68646aa82766":{"description":"Filter to specific holiday identifiers.","in":"query","name":"holiday","required":false,"schema":{"oneOf":[{"type":"array","items":{"description":"Public holiday\n\n### Available holidays\n\n- **no/forste_nyttarsdag** — January 1st.\n\n- **no/skjartorsdag** — The Thursday before Easter Sunday (moveable).\n\n- **no/langfredag** — The Friday before Easter Sunday (moveable).\n\n- **no/forste_paskedag** — Easter Sunday (moveable).\n\n- **no/andre_paskedag** — The Monday after Easter Sunday (moveable).\n\n- **no/arbeidernes_dag** — May 1st.\n\n- **no/kristi_himmelfartsdag** — Ascension Day, the Thursday 39 days after Easter (moveable).\n\n- **no/grunnlovsdag** — May 17th.\n\n- **no/forste_pinsedag** — Whit Sunday / Pentecost (moveable).\n\n- **no/andre_pinsedag** — Whit Monday (moveable).\n\n- **no/forste_juledag** — December 25th.\n\n- **no/andre_juledag** — December 26th.\n\n- **se/nyarsdagen** — January 1st.\n\n- **se/trettondagsafton** — January 5th (Epiphany Eve).\n\n- **se/trettondedag_jul** — January 6th (Epiphany).\n\n- **se/skartorsdagen** — The Thursday before Easter Sunday (moveable).\n\n- **se/langfredagen** — The Friday before Easter Sunday (moveable).\n\n- **se/paskafton** — The Saturday before Easter Sunday — Easter Eve (moveable).\n\n- **se/paskdagen** — Easter Sunday (moveable).\n\n- **se/annandag_pask** — The Monday after Easter Sunday (moveable).\n\n- **se/forsta_maj** — May 1st.\n\n- **se/kristi_himmelsfard** — Ascension Day, the Thursday 39 days after Easter (moveable).\n\n- **se/pingstafton** — Whitsun Eve, the Saturday before Pentecost (moveable).\n\n- **se/nationaldagen** — June 6th.\n\n- **se/midsommarafton** — The Friday before Midsummer Day (moveable).\n\n- **se/allhelgonaafton** — The Friday between October 30th and November 5th — All Saints' Eve.\n\n- **se/julafton** — December 24th.\n\n- **se/juldagen** — December 25th.\n\n- **se/annandag_jul** — December 26th.\n\n- **se/nyarsafton** — December 31st.","enum":["no/forste_nyttarsdag","no/skjartorsdag","no/langfredag","no/forste_paskedag","no/andre_paskedag","no/arbeidernes_dag","no/kristi_himmelfartsdag","no/grunnlovsdag","no/forste_pinsedag","no/andre_pinsedag","no/forste_juledag","no/andre_juledag","se/nyarsdagen","se/trettondagsafton","se/trettondedag_jul","se/skartorsdagen","se/langfredagen","se/paskafton","se/paskdagen","se/annandag_pask","se/forsta_maj","se/kristi_himmelsfard","se/pingstafton","se/nationaldagen","se/midsommarafton","se/allhelgonaafton","se/julafton","se/juldagen","se/annandag_jul","se/nyarsafton"],"examples":["no/forste_nyttarsdag"],"title":"Holiday","type":"string","uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"title":"Holiday","description":"Filter to specific holiday identifiers.","uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","title":"Holiday","description":"Filter to specific holiday identifiers.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[] | null"}}},"responses":{"94d4335f-2b1e-4062-ac91-b0bb7ba6e859":{"content":{"application/json":{"example":{"holidays":[{"date":"2026-12-25","holiday":"se/juldagen","timezone":"Europe/Stockholm"}]},"schema":{"description":"Holidays in the requested range.","properties":{"holidays":{"items":{"description":"A single occurrence of a holiday on a calendar date.","properties":{"date":{"format":"date","title":"Date","type":"string","isRequired":true,"uniqueKey":"holidays.items.[INDEX].date","typeLabel":"string\u003cdate>"},"holiday":{"description":"Public holiday\n\n### Available holidays\n\n- **no/forste_nyttarsdag** — January 1st.\n\n- **no/skjartorsdag** — The Thursday before Easter Sunday (moveable).\n\n- **no/langfredag** — The Friday before Easter Sunday (moveable).\n\n- **no/forste_paskedag** — Easter Sunday (moveable).\n\n- **no/andre_paskedag** — The Monday after Easter Sunday (moveable).\n\n- **no/arbeidernes_dag** — May 1st.\n\n- **no/kristi_himmelfartsdag** — Ascension Day, the Thursday 39 days after Easter (moveable).\n\n- **no/grunnlovsdag** — May 17th.\n\n- **no/forste_pinsedag** — Whit Sunday / Pentecost (moveable).\n\n- **no/andre_pinsedag** — Whit Monday (moveable).\n\n- **no/forste_juledag** — December 25th.\n\n- **no/andre_juledag** — December 26th.\n\n- **se/nyarsdagen** — January 1st.\n\n- **se/trettondagsafton** — January 5th (Epiphany Eve).\n\n- **se/trettondedag_jul** — January 6th (Epiphany).\n\n- **se/skartorsdagen** — The Thursday before Easter Sunday (moveable).\n\n- **se/langfredagen** — The Friday before Easter Sunday (moveable).\n\n- **se/paskafton** — The Saturday before Easter Sunday — Easter Eve (moveable).\n\n- **se/paskdagen** — Easter Sunday (moveable).\n\n- **se/annandag_pask** — The Monday after Easter Sunday (moveable).\n\n- **se/forsta_maj** — May 1st.\n\n- **se/kristi_himmelsfard** — Ascension Day, the Thursday 39 days after Easter (moveable).\n\n- **se/pingstafton** — Whitsun Eve, the Saturday before Pentecost (moveable).\n\n- **se/nationaldagen** — June 6th.\n\n- **se/midsommarafton** — The Friday before Midsummer Day (moveable).\n\n- **se/allhelgonaafton** — The Friday between October 30th and November 5th — All Saints' Eve.\n\n- **se/julafton** — December 24th.\n\n- **se/juldagen** — December 25th.\n\n- **se/annandag_jul** — December 26th.\n\n- **se/nyarsafton** — December 31st.","enum":["no/forste_nyttarsdag","no/skjartorsdag","no/langfredag","no/forste_paskedag","no/andre_paskedag","no/arbeidernes_dag","no/kristi_himmelfartsdag","no/grunnlovsdag","no/forste_pinsedag","no/andre_pinsedag","no/forste_juledag","no/andre_juledag","se/nyarsdagen","se/trettondagsafton","se/trettondedag_jul","se/skartorsdagen","se/langfredagen","se/paskafton","se/paskdagen","se/annandag_pask","se/forsta_maj","se/kristi_himmelsfard","se/pingstafton","se/nationaldagen","se/midsommarafton","se/allhelgonaafton","se/julafton","se/juldagen","se/annandag_jul","se/nyarsafton"],"examples":["no/forste_nyttarsdag"],"title":"Holiday","type":"string","isRequired":true,"uniqueKey":"holidays.items.[INDEX].holiday","typeLabel":"enum\u003cstring>"},"timezone":{"title":"Timezone","type":"string","isRequired":true,"uniqueKey":"holidays.items.[INDEX].timezone","typeLabel":"string"}},"required":["date","holiday","timezone"],"title":"HolidayOccurrence","type":"object","uniqueKey":"holidays.items.[INDEX]","typeLabel":"HolidayOccurrence · object"},"title":"Holidays","type":"array","isRequired":true,"uniqueKey":"holidays","typeLabel":"HolidayOccurrence · object[]"}},"required":["holidays"],"title":"HolidaysResponse","type":"object","uniqueKey":"","typeLabel":"HolidaysResponse · object"},"examples":{"Example":{"title":"Example","value":{"holidays":[{"date":"2026-12-25","holiday":"se/juldagen","timezone":"Europe/Stockholm"}]}}},"exampleType":"examples"}},"description":"Successful Response","exampleType":"examples"},"4a215c68-00ed-41b4-a906-ab11e86c30b3":{"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":{"90649cf1-42fb-4b2d-80f2-b035fab699a5":{"apiKeyAuth":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"e2d0fd42-3318-4d8b-9552-91334ce074b8":{"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":"List holidays - Engrate Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-04T06:54:40.876Z","originalFileLocation":"api-reference/core/holidays.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=\"List public holidays in a range of years. Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.\">\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=\"List holidays - Engrate Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"List public holidays in a range of years. Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.\">\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/core/holidays\">\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=Core\u0026amp;title=List+holidays\u0026amp;description=List+public+holidays+in+a+range+of+years.%0A%0AReturns+the+holiday+occurrences+for+years+in+%60%5Bstart_year%2C+end_year%29%60+%28%60start_year%60+inclusive%2C+%60end_year%60+exclusive%29.\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=84cbd5b6f85df876b75d1c800fbac7bb92d14e6a54c4e8c1e139b0d65b442e94\">\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=\"List holidays - Engrate Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List public holidays in a range of years. Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://engrate.mintlify.app/_mintlify/api/og/v2?division=Core\u0026amp;title=List+holidays\u0026amp;description=List+public+holidays+in+a+range+of+years.%0A%0AReturns+the+holiday+occurrences+for+years+in+%60%5Bstart_year%2C+end_year%29%60+%28%60start_year%60+inclusive%2C+%60end_year%60+exclusive%29.\u0026amp;theme=afa5e8a3bcc00498066c4a3e\u0026amp;signature=84cbd5b6f85df876b75d1c800fbac7bb92d14e6a54c4e8c1e139b0d65b442e94\">\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/core/holidays\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/core/holidays.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/core/holidays#webpage\",\"url\":\"https://docs.engrate.io/api-reference/core/holidays\",\"name\":\"List holidays\",\"description\":\"List public holidays in a range of years. Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.\",\"dateModified\":\"2026-06-04T06:54:40.876Z\",\"isPartOf\":{\"@id\":\"https://docs.engrate.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.engrate.io/api-reference/core/holidays#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.engrate.io/api-reference/core/holidays#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core\",\"item\":\"https://docs.engrate.io/api-reference/core/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List holidays\",\"item\":\"https://docs.engrate.io/api-reference/core/holidays\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.engrate.io/api-reference/core/holidays#apireference\",\"headline\":\"List holidays\",\"name\":\"List holidays\",\"description\":\"List public holidays in a range of years. Returns the holiday occurrences for years in [start_year, end_year) (start_year inclusive, end_year exclusive). Optionally filterable by country (ISO 3166-1 alpha-2 lowercase) and by specific holiday identifiers (e.g. se/julafton). Each occurrence carries the IANA timezone in which the holiday is observed.\",\"url\":\"https://docs.engrate.io/api-reference/core/holidays\",\"mainEntityOfPage\":{\"@id\":\"https://docs.engrate.io/api-reference/core/holidays#webpage\"},\"dateModified\":\"2026-06-04T06:54:40.876Z\",\"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":"Guides","pages":[{"title":"Guides","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","description":"Get GeoJSON data for electricity grid entities.\n\nReturns a standard [GeoJSON FeatureCollection](https://datatracker.ietf.org/doc/html/rfc7946) in WGS84. The properties field contains the normal data fields for the entity returned, plus a `type` field indicating the entity type.\n\nThis currently supports [Metering Grid Area](/api-reference/core/models/metering-grid-area).\n\nMultiple values for the same filter are OR-ed; different filters are AND-ed.","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","description":"Calculate the cost of energy","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","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":"Schedule Management","pages":[{"title":"Schedule Management API Overview","href":"/api-reference/schedule-management/overview"},{"title":"Schedule Lifecycle","href":"/api-reference/schedule-management/schedule-lifecycle"},{"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 Version","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/versions/{version_number}","href":"/api-reference/schedules/get-schedule-version"},{"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":"Get Delivery Status","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/delivery-status","href":"/api-reference/schedules/get-delivery-status"},{"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"},{"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"},{"title":"Get Schedule Anomalies","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/anomalies","href":"/api-reference/schedules/get-schedule-anomalies"},{"title":"Get Schedule Reconciliation","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/schedules/{uid}/reconciliation","href":"/api-reference/schedules/get-schedule-reconciliation"},{"title":"List Anomalies","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/anomalies","href":"/api-reference/schedules/list-anomalies"}]},{"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"}]},{"group":"Settlement Management (MaBiS)","pages":[{"title":"Settlement Management API Overview","href":"/api-reference/settlement-management/overview"},{"title":"Clearing \u0026 Settlement Flow","href":"/api-reference/settlement-management/clearing-settlement-flow"},{"group":"Models","icon":"cube","pages":[{"title":"Clearing Period","href":"/api-reference/settlement-management/models/clearing-period"},{"title":"Clearing Settlement","href":"/api-reference/settlement-management/models/clearing-settlement"},{"title":"Objection","href":"/api-reference/settlement-management/models/objection"},{"title":"Aggregation Object","href":"/api-reference/settlement-management/models/aggregation-object"},{"title":"Energy Volume","href":"/api-reference/settlement-management/models/energy-volume"},{"title":"Imbalance","href":"/api-reference/settlement-management/models/imbalance"},{"title":"Control Energy Price","href":"/api-reference/settlement-management/models/control-energy-price"},{"title":"Monthly Summary","href":"/api-reference/settlement-management/models/monthly-summary"},{"title":"Clearing Calendar","href":"/api-reference/settlement-management/models/clearing-calendar"}]},{"title":"List Clearing Periods","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods","href":"/api-reference/mabis/list-clearing-periods"},{"title":"Create Clearing Period","deprecated":null,"version":null,"openapi":"/openapi.json post /schedule-management/v1/mabis/clearing-periods","href":"/api-reference/mabis/create-clearing-period"},{"title":"Get Clearing Period","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}","href":"/api-reference/mabis/get-clearing-period"},{"title":"List Settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}/settlements","href":"/api-reference/mabis/list-settlements"},{"title":"List Objections","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}/objections","href":"/api-reference/mabis/list-objections"},{"title":"Create Objection","deprecated":null,"version":null,"openapi":"/openapi.json post /schedule-management/v1/mabis/clearing-periods/{uid}/objections","href":"/api-reference/mabis/create-objection"},{"title":"List Messages","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}/messages","href":"/api-reference/mabis/list-messages"},{"title":"Calculate Imbalance","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}/imbalance","href":"/api-reference/mabis/calculate-imbalance"},{"title":"Validate Clearing Data","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-periods/{uid}/validate","href":"/api-reference/mabis/validate-clearing-data"},{"title":"Get Control Energy Prices","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/control-energy-prices","href":"/api-reference/mabis/get-control-energy-prices"},{"title":"List Aggregation Objects","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/aggregation-objects","href":"/api-reference/mabis/list-aggregation-objects"},{"title":"Send Response To Aggregation Time Series","deprecated":null,"version":null,"openapi":"/openapi.json post /schedule-management/v1/mabis/send-response-to-aggregation-time-series","href":"/api-reference/mabis/send-response-to-aggregation-time-series"},{"title":"List Energy Volumes","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/energy-volumes","href":"/api-reference/mabis/list-energy-volumes"},{"title":"Get Monthly Summary","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/energy-volumes/{mabis_zp_id}/monthly-summary","href":"/api-reference/mabis/get-monthly-summary"},{"title":"Get Clearing Calendar","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule-management/v1/mabis/clearing-calendar","href":"/api-reference/mabis/get-clearing-calendar"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"title":"List holidays - Engrate Developer Documentation","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}