Reading needs no key. A key raises your limit and shows you your usage.
Every public endpoint works without a key, at 120 requests per minute per
address (limits). A key is for integrations that need more, or
that want to subscribe to tariff changes.
Tiers
Tier
Requests per minute
No key
120, per address
free
300
pro
1’200
enterprise
6’000
The limit is per key, wherever the requests come from.
Getting a key
A free key is yours in a minute, without waiting for anyone:
A link arrives at that address, good for 24 hours. Opening it shows your key,
once. Asking again for the same address replaces your free key, which is how a
lost key is replaced: only its hash is stored, so it cannot be shown again.pro and enterprise keys are issued by the team that runs this service; ask
through n:lead.
Self-service sign-up opens with the terms of use. Until then the endpoint
answers 404, and keys are issued by hand.
Usage is counted per day and endpoint, with identifiers taken out of the path,
so five hundred operators read one by one count as one endpoint. Counts are
written about once a minute; the last minute may not show yet.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"n:lead Swiss Tariffs","description":"Electricity tariffs for every Swiss distribution grid operator — free to read, no key needed.","colors":{"primary":"#16A34A","light":"#4ADE80","dark":"#166534"},"favicon":"https://mintcdn.com/n-lead-gmb-h/-lYu_hb9r5KxqC-_/favicon.svg?fit=max\u0026auto=format\u0026n=-lYu_hb9r5KxqC-_\u0026q=85\u0026s=280c9a6417ef9866a35756d70b7df10e","navbar":{"links":[{"href":"https://ch-el-tarif-db.azurewebsites.net/","label":"Map"},{"href":"https://nlead.ch","label":"n:lead"}],"primary":{"type":"button","label":"Try a request","href":"https://ch-el-tarif-db.azurewebsites.net/api/v1/periods"}},"footer":{"socials":{"website":"https://ch-el-tarif-db.azurewebsites.net/"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"n-lead-gmb-h","hasAudioNarration":false,"actualSubdomain":"n-lead-gmb-h","customDomains":[],"gitSource":{"type":"github","owner":"n-lead-gmbh","repo":"ch_el_tarif_db","deployBranch":"main","contentDirectory":"docs/api","isPrivate":true,"mountPath":"","label":"","_id":"6b007a58fc164d89a13225bf"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b007ab8fc164d89a1322c76","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API reference","count":47},{"language":"default","tag":"map and app data","count":19},{"language":"default","tag":"dataset","count":17},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"How to","count":6},{"language":"default","tag":"Reading the data","count":4},{"language":"default","tag":"Using the API well","count":3},{"language":"default","tag":"account","count":3},{"language":"default","tag":"webhooks","count":3},{"language":"default","tag":"Start here","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"keys","slug":"/keys","pageMetadata":{"title":"API keys and usage","description":"Reading needs no key. A key raises your limit and shows you your usage.","href":"/keys"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Reading needs no key. A key raises your limit and shows you your usage.\"\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={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every public endpoint works without a key, at `,_jsx(_components.strong,{children:`120 requests per minute per\naddress`}),` (`,_jsx(_components.a,{href:`/limits`,children:`limits`}),`). A key is for integrations that need more, or\nthat want to subscribe to `,_jsx(_components.a,{href:`/webhooks`,children:`tariff changes`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`tiers`,children:`Tiers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tier`}),_jsx(_components.th,{children:`Requests per minute`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No key`}),_jsx(_components.td,{children:`120, per address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`free`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`300`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pro`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1’200`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`enterprise`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`6’000`})]})]})]}),`\n`,_jsx(_components.p,{children:`The limit is per key, wherever the requests come from.`}),`\n`,_jsx(Heading,{level:`2`,id:`getting-a-key`,children:`Getting a key`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`free`}),` key is yours in a minute, without waiting for anyone:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TARIFF_API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/api/v1/signup\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"name\": \"Example AG\", \"email\": \"dev@example.ch\", \"accept_terms\": true}'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`A link arrives at that address, good for 24 hours. Opening it shows your key,\nonce. Asking again for the same address replaces your free key, which is how a\nlost key is replaced: only its hash is stored, so it cannot be shown again.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`pro`}),` and `,_jsx(_components.code,{children:`enterprise`}),` keys are issued by the team that runs this service; ask\nthrough `,_jsx(_components.a,{href:`https://nlead.ch/#contact`,children:`n:lead`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Self-service sign-up opens with the terms of use. Until then the endpoint\nanswers `,_jsx(_components.code,{children:`404`}),`, and keys are issued by hand.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`sending-your-key`,children:`Sending your key`}),`\n`,_jsx(_components.p,{children:`Either header works:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TARIFF_API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/api/v1/periods\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TARIFF_API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/api/v1/periods\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Every response says which tier served it, in `,_jsx(_components.code,{children:`X-API-Tier`}),`, beside the usual\n`,_jsx(_components.code,{children:`X-RateLimit-*`}),` headers.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A key that is unknown or revoked gets a `,_jsx(_components.code,{children:`401`}),`, not anonymous access. A typo in\nyour configuration shows up at once instead of as a silently lower limit.`]})}),`\n`,_jsx(_components.p,{children:`The key is shown once, when it is created. Only its hash is stored, so a lost\nkey cannot be recovered, only replaced.`}),`\n`,_jsx(Heading,{level:`2`,id:`your-usage`,children:`Your usage`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TARIFF_API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/api/v1/usage?days=30\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example AG\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit_per_minute\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"day\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/api/v1/dsos/{id}/tariffs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"n\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5210`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"day\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/api/v1/tariffs/export\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"n\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Usage is counted per day and endpoint, with identifiers taken out of the path,\nso five hundred operators read one by one count as one endpoint. Counts are\nwritten about once a minute; the last minute may not show yet.`})]})}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":"API keys and usage","description":"Reading needs no key. A key raises your limit and shows you your usage.","href":"/keys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Tiers","slug":"tiers","depth":2,"children":[]},{"title":"Getting a key","slug":"getting-a-key","depth":2,"children":[]},{"title":"Sending your key","slug":"sending-your-key","depth":2,"children":[]},{"title":"Your usage","slug":"your-usage","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"n-lead-gmb-h","siteName":"n:lead Swiss Tariffs","title":"API keys and usage - n:lead Swiss Tariffs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T16:52:25.228Z","originalFileLocation":"keys.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=\"Reading needs no key. A key raises your limit and shows you your usage.\">\u003cmeta data-mint-head name=\"application-name\" content=\"n:lead Swiss Tariffs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"API keys and usage - n:lead Swiss Tariffs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reading needs no key. A key raises your limit and shows you your usage.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"n:lead Swiss Tariffs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://n-lead-gmb-h.mintlify.app/keys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://n-lead-gmb-h.mintlify.site/_mintlify/api/og/v2?division=Using+the+API+well\u0026amp;title=API+keys+and+usage\u0026amp;description=Reading+needs+no+key.+A+key+raises+your+limit+and+shows+you+your+usage.\u0026amp;theme=a3dd3926235ae5fa6e742672\u0026amp;signature=4ffbdd3666c705dff0a3656a299cb66f31db3c1ac332111bfa67f71790543c57\">\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=\"API keys and usage - n:lead Swiss Tariffs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reading needs no key. A key raises your limit and shows you your usage.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://n-lead-gmb-h.mintlify.site/_mintlify/api/og/v2?division=Using+the+API+well\u0026amp;title=API+keys+and+usage\u0026amp;description=Reading+needs+no+key.+A+key+raises+your+limit+and+shows+you+your+usage.\u0026amp;theme=a3dd3926235ae5fa6e742672\u0026amp;signature=4ffbdd3666c705dff0a3656a299cb66f31db3c1ac332111bfa67f71790543c57\">\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/n-lead-gmb-h/BbxIM_rijXwZRgi_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"n:lead Swiss Tariffs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://n-lead-gmb-h.mintlify.app/keys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/keys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://n-lead-gmb-h.mintlify.app/#organization\",\"name\":\"n:lead Swiss Tariffs\",\"url\":\"https://n-lead-gmb-h.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://n-lead-gmb-h.mintlify.app#website\",\"name\":\"n:lead Swiss Tariffs\",\"url\":\"https://n-lead-gmb-h.mintlify.app\",\"publisher\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://n-lead-gmb-h.mintlify.app/keys#webpage\",\"url\":\"https://n-lead-gmb-h.mintlify.app/keys\",\"name\":\"API keys and usage\",\"description\":\"Reading needs no key. A key raises your limit and shows you your usage.\",\"dateModified\":\"2026-11-20T16:52:25.228Z\",\"isPartOf\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app/keys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://n-lead-gmb-h.mintlify.app/keys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Using the API well\",\"item\":\"https://n-lead-gmb-h.mintlify.app/limits\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API keys and usage\",\"item\":\"https://n-lead-gmb-h.mintlify.app/keys\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://n-lead-gmb-h.mintlify.app/keys#article\",\"headline\":\"API keys and usage\",\"name\":\"API keys and usage\",\"description\":\"Reading needs no key. A key raises your limit and shows you your usage.\",\"url\":\"https://n-lead-gmb-h.mintlify.app/keys\",\"mainEntityOfPage\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app/keys#webpage\"},\"dateModified\":\"2026-11-20T16:52:25.228Z\",\"publisher\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://n-lead-gmb-h.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"n:lead Swiss Tariffs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"n:lead Swiss Tariffs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/keys.md","siteName":"n:lead Swiss Tariffs","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Start here","pages":[{"title":"n:lead Swiss Tariffs","sidebarTitle":"Overview","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Reading the data","pages":[{"title":"Provenance","href":"/concepts/provenance"},{"title":"What is in a tariff","href":"/concepts/tariffs"},{"title":"Coverage and empty answers","href":"/concepts/coverage"},{"title":"Accuracy","href":"/concepts/accuracy"}]},{"group":"How to","pages":[{"title":"Find one tariff","href":"/guides/find-a-tariff"},{"title":"Price a business","href":"/guides/business-bill"},{"title":"Filter every operator","href":"/guides/filter-by-tariff"},{"title":"Take the whole dataset","href":"/guides/bulk"},{"title":"Price by the quarter-hour","href":"/guides/time-series"},{"title":"Feed-in remuneration","href":"/guides/feed-in"}]},{"group":"Using the API well","pages":[{"title":"Caching and limits","description":"How to use a free API without being the reason it stops being free.","href":"/limits"},{"title":"API keys and usage","href":"/keys"},{"title":"Tariff-change webhooks","description":"A signed POST when an operator's published tariffs change, instead of polling.","href":"/webhooks"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/find-a-tariff/map-tariffs"}]}]},"basePath":"","title":"API keys and usage - n:lead Swiss Tariffs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}