Which environmental impact indicators to include in the impacts field. Absent or empty returns only GWP-fossil. Pass all for every indicator, or a comma-separated list of canonical codes to filter (case-insensitive). all is only honored on its own — combining it with other codes (e.g. all,gwp-fossil) is treated as an unknown code. An unknown code returns 400. See the Impacts concept and the full indicator catalog.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Variable API","colors":{"primary":"#282624","light":"#E6E3DD","dark":"#282624"},"logo":{"light":"https://app.variable.global/logo/logo-horizontal-onlight.svg","dark":"https://app.variable.global/logo/logo-horizontal-ondark.svg"},"favicon":"https://mintcdn.com/variable/-esaLwUuP4fnFDIg/logo/symbol-white.svg?fit=max\u0026auto=format\u0026n=-esaLwUuP4fnFDIg\u0026q=85\u0026s=d0fcf1de9144c23f8a7d44e3c52638a0","api":{"playground":{"display":"simple"}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@variable.co","label":"Support"}],"primary":{"type":"button","label":"App","href":"https://app.variable.global"}},"footer":{"socials":{"discord":"https://discord.gg/TrGYZW7zPG","linkedin":"https://www.linkedin.com/company/variable-co","x":"https://x.com/variableHQ"}},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"variable","hasAudioNarration":false,"actualSubdomain":"variable","customDomains":["docs.variable.global"],"gitSource":{"type":"github","owner":"variable-co","repo":"cascade","deployBranch":"main","contentDirectory":"api-documentation","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af3395d84c63df72598eccc","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":87},{"language":"default","tag":"Documentation","count":31},{"language":"default","tag":"Elements","count":28},{"language":"default","tag":"Getting started","count":14},{"language":"default","tag":"Changelog","count":10},{"language":"default","tag":"Switch","count":8},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"Help articles","count":8},{"language":"default","tag":"PACT API","count":8},{"language":"default","tag":"Activity","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v1/switch/list","slug":"/api-reference/v1/switch/list","pageMetadata":{"title":"List Switches","openapi":"GET /v1/switch","description":"Get a list of Switches","href":"/api-reference/v1/switch/list"},"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: \"Get a list of Switches\"\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];const permission_0=`switch:read`;function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info,Note}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(Info,{children:[`Requires permission: `,_jsx(_components.strong,{children:permission_0})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Read more about the `,_jsx(_components.a,{href:`/docs/switch`,children:`Switch`}),` data model.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{permission_0,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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"List Switches","openapi":"GET /v1/switch","description":"Get a list of Switches","href":"/api-reference/v1/switch/list"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[511,530,"`switch:read`})]}),`"]]},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get a list of Switches","security":["9391b459-25c9-4e2c-b666-faab6eeabbed"],"parameters":["755ff0f9-1197-417d-be5e-c741587dcc5d"],"responses":{"200":"18ad759d-d40c-4dd6-a5e2-df190f82e183","401":"463e060c-f37c-4e69-8743-fca93130559a"},"method":"get","type":"path","servers":["474f6128-2410-41da-aeba-18a544df26e0"],"path":"/v1/switch","baseUrlOptions":["https://app.variable.global/api"],"title":"Get a list of Switches","description":"Get a list of Switches","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"755ff0f9-1197-417d-be5e-c741587dcc5d":{"name":"impacts","in":"query","description":"Which environmental impact indicators to include in the `impacts` field. Absent or empty returns only `GWP-fossil`. Pass `all` for every indicator, or a comma-separated list of canonical codes to filter (case-insensitive). `all` is only honored on its own — combining it with other codes (e.g. `all,gwp-fossil`) is treated as an unknown code. An unknown code returns `400`. See the [Impacts](/docs/impacts) concept and the full [indicator catalog](/docs/help/impact-indicators).","required":false,"schema":{"type":"string","example":"gwp-fossil,odp,ap","isRequired":false,"description":"Which environmental impact indicators to include in the `impacts` field. Absent or empty returns only `GWP-fossil`. Pass `all` for every indicator, or a comma-separated list of canonical codes to filter (case-insensitive). `all` is only honored on its own — combining it with other codes (e.g. `all,gwp-fossil`) is treated as an unknown code. An unknown code returns `400`. See the [Impacts](/docs/impacts) concept and the full [indicator catalog](/docs/help/impact-indicators).","uniqueKey":"","typeLabel":"string"}}},"responses":{"18ad759d-d40c-4dd6-a5e2-df190f82e183":{"description":"A list of Switches","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"data.items.[INDEX].uuid","typeLabel":"string\u003cuuid>"},"syncId":{"type":"string","description":"An identifier to use when syncing data with other systems. [Read more](/docs/syncId)","example":"sync123","uniqueKey":"data.items.[INDEX].syncId","typeLabel":"string"},"name":{"type":"string","example":"Switch Name","uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"unit":{"type":"string","example":"kg","description":"The unit code (e.g. kg, lbs, etc.). All unit codes can be found in the [List Units](/api-reference/v1/unit/get) endpoint.","uniqueKey":"data.items.[INDEX].unit","typeLabel":"string"},"image":{"type":"string","example":"https://app.variable.global/uploads/image.jpg","uniqueKey":"data.items.[INDEX].image","typeLabel":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","uniqueKey":"data.items.[INDEX].sources.items.[INDEX].uuid","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Name","uniqueKey":"data.items.[INDEX].sources.items.[INDEX].name","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].sources","typeLabel":"object[]"},"footprint":{"deprecated":true,"description":"Deprecated — use `impacts[\"GWP-fossil\"]`. Kept for backwards compatibility.","properties":{"CO2e":{"properties":{"productCarbonFootprint":{"type":"string","example":"1234.5678","uniqueKey":"data.items.[INDEX].footprint.CO2e.productCarbonFootprint","typeLabel":"string"},"A1_A3":{"type":"string","example":"1234.5678","uniqueKey":"data.items.[INDEX].footprint.CO2e.A1_A3","typeLabel":"string"}},"type":"object","uniqueKey":"data.items.[INDEX].footprint.CO2e","typeLabel":"object"}},"type":"object","uniqueKey":"data.items.[INDEX].footprint","typeLabel":"object"},"impacts":{"type":"object","description":"Environmental impact indicators keyed by canonical code (e.g. `GWP-fossil`, `ODP`, `AP`). Which indicators appear is controlled by the `impacts` query parameter — by default only `GWP-fossil` is returned.","additionalProperties":{"type":"object","description":"One environmental impact indicator. `unit` and `method` describe the indicator; the remaining fields carry its values — both individual life-cycle stages (`A1`, `A2`, `A3`, …) and aggregated totals (`totalCarbonFootprint`, `A1_A3`, …). A value that is genuinely zero is the string `\"0\"`; a missing one is absent. `method` is `Mixed` when the total aggregates two or more components from different methods — common for the headline `GWP-fossil` total.","properties":{"totalCarbonFootprint":{"type":"string","example":"1234.5678","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.totalCarbonFootprint","typeLabel":"string"},"productCarbonFootprint":{"type":"string","example":"1234.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.productCarbonFootprint","typeLabel":"string"},"upstream":{"type":"string","example":"1230.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.upstream","typeLabel":"string"},"direct":{"type":"string","example":"4.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.direct","typeLabel":"string"},"downstream":{"type":"string","example":"0.5678","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.downstream","typeLabel":"string"},"A1_A3":{"type":"string","example":"1234.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.A1_A3","typeLabel":"string"},"A1":{"type":"string","example":"1200.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.A1","typeLabel":"string"},"A2":{"type":"string","example":"30.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.A2","typeLabel":"string"},"A3":{"type":"string","example":"4.0","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.A3","typeLabel":"string"},"A4":{"type":"string","example":"0.5","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.A4","typeLabel":"string"},"B1":{"type":"string","example":"0.06","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.B1","typeLabel":"string"},"B2":{"type":"string","example":"0.007","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.B2","typeLabel":"string"},"B3":{"type":"string","example":"0.0008","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.B3","typeLabel":"string"},"B4":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.B4","typeLabel":"string"},"B5":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.B5","typeLabel":"string"},"C1":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.C1","typeLabel":"string"},"C2":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.C2","typeLabel":"string"},"C3":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.C3","typeLabel":"string"},"C4":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.C4","typeLabel":"string"},"D":{"type":"string","example":"","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.D","typeLabel":"string"},"unit":{"type":"string","example":"kgCO2e","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.unit","typeLabel":"string"},"method":{"type":"string","example":"EN15804+A2 - Core impact categories and indicators","uniqueKey":"data.items.[INDEX].impacts.additionalProperties.method","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].impacts.additionalProperties","typeLabel":"object"},"example":{"GWP-fossil":{"unit":"kgCO2e","method":"Mixed","totalCarbonFootprint":"10","A1_A3":"10"},"ODP":{"unit":"kgCFC11e","method":"EN15804+A2 - Core impact categories and indicators","A1_A3":"0.0000012"},"AP":{"unit":"molH+e","method":"EN15804+A2 - Core impact categories and indicators","A1_A3":"2"}},"uniqueKey":"data.items.[INDEX].impacts","typeLabel":"object"},"created":{"type":"string","description":"ISO 8601 date","example":"2021-01-01T00:00:00.000Z","uniqueKey":"data.items.[INDEX].created","typeLabel":"string"},"updated":{"type":"string","description":"ISO 8601 date","example":"2021-01-31T23:59:59.000Z","uniqueKey":"data.items.[INDEX].updated","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","syncId":"sync123","name":"Switch Name","unit":"kg","image":"https://app.variable.global/uploads/image.jpg","sources":[{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"Name"}],"footprint":{"CO2e":{"productCarbonFootprint":"1234.5678","A1_A3":"1234.5678"}},"impacts":{"GWP-fossil":{"unit":"kgCO2e","method":"Mixed","totalCarbonFootprint":"10","A1_A3":"10"},"ODP":{"unit":"kgCFC11e","method":"EN15804+A2 - Core impact categories and indicators","A1_A3":"0.0000012"},"AP":{"unit":"molH+e","method":"EN15804+A2 - Core impact categories and indicators","A1_A3":"2"}},"created":"2021-01-01T00:00:00.000Z","updated":"2021-01-31T23:59:59.000Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"463e060c-f37c-4e69-8743-fca93130559a":{"description":"ExpiredToken","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"token expired","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"token expired"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9391b459-25c9-4e2c-b666-faab6eeabbed":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"474f6128-2410-41da-aeba-18a544df26e0":{"url":"https://app.variable.global/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"variable","siteName":"Variable API","title":"List Switches - Variable API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-16T08:34:31.779Z","originalFileLocation":"api-reference/v1/switch/list.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get a list of Switches\">\u003cmeta data-mint-head name=\"application-name\" content=\"Variable API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_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/variable/XSEKUEE_r7PB-_3g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Switches - Variable API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a list of Switches\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Variable API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.variable.global/api-reference/v1/switch/list\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Switch\u0026amp;title=List+Switches\u0026amp;description=Get+a+list+of+Switches\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=561b6e2648b9fa3ff84ae1ac8cf7b09ad7e2cf710cfd78417db82e30c1aff058\">\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 Switches - Variable API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a list of Switches\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://variable.mintlify.site/_mintlify/api/og/v2?division=Switch\u0026amp;title=List+Switches\u0026amp;description=Get+a+list+of+Switches\u0026amp;theme=fd7c09a692b44be01087e493\u0026amp;signature=561b6e2648b9fa3ff84ae1ac8cf7b09ad7e2cf710cfd78417db82e30c1aff058\">\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/variable/XSEKUEE_r7PB-_3g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Variable API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#282624\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.variable.global/api-reference/v1/switch/list\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/switch/list.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.variable.global/#organization\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://app.variable.global/logo/logo-horizontal-onlight.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.variable.global#website\",\"name\":\"Variable API\",\"url\":\"https://docs.variable.global\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.variable.global/api-reference/v1/switch/list#webpage\",\"url\":\"https://docs.variable.global/api-reference/v1/switch/list\",\"name\":\"List Switches\",\"description\":\"Get a list of Switches\",\"dateModified\":\"2025-08-16T08:34:31.779Z\",\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.variable.global/api-reference/v1/switch/list#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.variable.global/api-reference/v1/switch/list#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Variable API\",\"item\":\"https://docs.variable.global\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Switches\",\"item\":\"https://docs.variable.global/api-reference/v1/switch/list\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.variable.global/api-reference/v1/switch/list#apireference\",\"headline\":\"List Switches\",\"name\":\"List Switches\",\"description\":\"Get a list of Switches\",\"url\":\"https://docs.variable.global/api-reference/v1/switch/list\",\"mainEntityOfPage\":{\"@id\":\"https://docs.variable.global/api-reference/v1/switch/list#webpage\"},\"dateModified\":\"2025-08-16T08:34:31.779Z\",\"publisher\":{\"@id\":\"https://docs.variable.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.variable.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Variable API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Variable API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/getting-started/welcome"}]},{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"REST API","href":"/api-reference/welcome"}]},{"group":"Auth token","pages":[{"title":"API key","href":"/api-reference/auth/token/api-key"},{"title":"Get Token","openapi":"POST /auth/token","href":"/api-reference/auth/token/post"}]},{"group":"Database","pages":[{"title":"Search","openapi":"GET /v1/search","href":"/api-reference/v1/search/list"}]},{"group":"Product","pages":[{"title":"List Products","openapi":"GET /v1/product","href":"/api-reference/v1/product/list/get"},{"title":"Get Product","openapi":"GET /v1/product/{uuid}","href":"/api-reference/v1/product/get"},{"title":"Create Product","openapi":"POST /v1/product","href":"/api-reference/v1/product/post"},{"title":"Edit Product","openapi":"PATCH /v1/product/{uuid}","href":"/api-reference/v1/product/patch"},{"title":"Product Image","openapi":"PATCH /v1/product/{uuid}/image","href":"/api-reference/v1/product/image"},{"title":"Delete Product","openapi":"DELETE /v1/product/{uuid}","href":"/api-reference/v1/product/delete"}]},{"group":"Elements","pages":[{"group":"Material","pages":[{"title":"List Materials","openapi":"GET /v1/material","href":"/api-reference/v1/material/list/get"},{"title":"Get Material","openapi":"GET /v1/material/{uuid}","href":"/api-reference/v1/material/get"},{"title":"Create Material","openapi":"POST /v1/material","href":"/api-reference/v1/material/post"},{"title":"Update Material","openapi":"PATCH /v1/material/{uuid}","href":"/api-reference/v1/material/patch"},{"title":"Material Image","openapi":"PATCH /v1/material/{uuid}/image","href":"/api-reference/v1/material/image"},{"title":"Delete Material","openapi":"DELETE /v1/material/{uuid}","href":"/api-reference/v1/material/delete"}]},{"group":"Transport Lane","pages":[{"title":"List Transport Lanes","openapi":"GET /v1/transport/lane","href":"/api-reference/v1/transport/lane/list/get"},{"title":"Get Transport Lane","openapi":"GET /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/get"},{"title":"Create Transport Lane","openapi":"POST /v1/transport/lane","href":"/api-reference/v1/transport/lane/post"},{"title":"Update Transport Lane","openapi":"PATCH /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/patch"},{"title":"Delete Transport Lane","openapi":"DELETE /v1/transport/lane/{uuid}","href":"/api-reference/v1/transport/lane/delete"}]},{"group":"Transport Mode","pages":[{"title":"List Transport Modes","openapi":"GET /v1/transport/mode","href":"/api-reference/v1/transport/mode/list/get"},{"title":"Get Transport Mode","openapi":"GET /v1/transport/mode/{code}","href":"/api-reference/v1/transport/mode/get"},{"title":"Create Transport Mode","openapi":"POST /v1/transport/mode","href":"/api-reference/v1/transport/mode/post"},{"title":"Update Transport Mode","openapi":"PATCH /v1/transport/mode/{code}","href":"/api-reference/v1/transport/mode/patch"},{"title":"Delete Transport Mode","openapi":"DELETE /v1/transport/mode/{code}","href":"/api-reference/v1/transport/mode/delete"}]},{"group":"Energy","pages":[{"title":"List Energy","openapi":"GET /v1/energy","href":"/api-reference/v1/energy/list/get"},{"title":"Get Energy","openapi":"GET /v1/energy/{uuid}","href":"/api-reference/v1/energy/get"},{"title":"Create Energy","openapi":"POST /v1/energy","href":"/api-reference/v1/energy/post"},{"title":"Update Energy","openapi":"PATCH /v1/energy/{uuid}","href":"/api-reference/v1/energy/patch"},{"title":"Energy Image","openapi":"PATCH /v1/energy/{uuid}/image","href":"/api-reference/v1/energy/image"},{"title":"Delete Energy","openapi":"DELETE /v1/energy/{uuid}","href":"/api-reference/v1/energy/delete"}]},{"group":"Process","pages":[{"title":"List Processes","openapi":"GET /v1/process","href":"/api-reference/v1/process/list/get"},{"title":"Get Process","openapi":"GET /v1/process/{uuid}","href":"/api-reference/v1/process/get"},{"title":"Create Process","openapi":"POST /v1/process","href":"/api-reference/v1/process/post"},{"title":"Update Process","openapi":"PATCH /v1/process/{uuid}","href":"/api-reference/v1/process/patch"},{"title":"Process Image","openapi":"PATCH /v1/process/{uuid}/image","href":"/api-reference/v1/process/image"},{"title":"Delete Process","openapi":"DELETE /v1/process/{uuid}","href":"/api-reference/v1/process/delete"}]}]},{"group":"Dataset","pages":[{"title":"List Datasets","openapi":"GET /v1/dataset","href":"/api-reference/v1/dataset/list/get"},{"title":"Get Dataset","openapi":"GET /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/get"},{"title":"Create Dataset","openapi":"POST /v1/dataset","href":"/api-reference/v1/dataset/post"},{"title":"Update Dataset","openapi":"PATCH /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/patch"},{"title":"Set Dataset Impacts","openapi":"PUT /v1/dataset/{uuid}/impacts","href":"/api-reference/v1/dataset/impacts/put"},{"title":"Dataset Image","openapi":"PATCH /v1/dataset/{uuid}/image","href":"/api-reference/v1/dataset/image"},{"title":"Delete Dataset","openapi":"DELETE /v1/dataset/{uuid}","href":"/api-reference/v1/dataset/delete"}]},{"group":"Model","pages":[{"title":"List Inputs","openapi":"GET /v1/model/{uuid}/input","href":"/api-reference/v1/model/inputs/get"},{"title":"Create Input","openapi":"POST /v1/model/{uuid}/input","href":"/api-reference/v1/model/inputs/post"},{"title":"Edit Input","openapi":"PATCH /v1/model/{modelId}/input/{inputId}","href":"/api-reference/v1/model/inputs/patch"},{"title":"Delete Input","openapi":"DELETE /v1/model/{modelId}/input/{inputId}","description":"Delete model input","href":"/api-reference/v1/model/inputs/delete"}]},{"group":"Switch","pages":[{"title":"List Switches","openapi":"GET /v1/switch","href":"/api-reference/v1/switch/list"},{"title":"Get Switch","openapi":"GET /v1/switch/{uuid}","description":"Get a switch by UUID","href":"/api-reference/v1/switch/get"},{"title":"Create Switch","openapi":"POST /v1/switch","href":"/api-reference/v1/switch/post"},{"title":"Edit Switch","openapi":"PATCH /v1/switch/{uuid}","href":"/api-reference/v1/switch/patch"},{"title":"Switch Image","openapi":"PATCH /v1/switch/{uuid}/image","href":"/api-reference/v1/switch/image"},{"title":"Delete Switch","openapi":"DELETE /v1/switch/{uuid}","href":"/api-reference/v1/switch/delete"},{"title":"Add Source","openapi":"POST /v1/switch/{switchId}/source/{sourceId}","href":"/api-reference/v1/switch/add-source"},{"title":"Remove Source","openapi":"DELETE /v1/switch/{switchId}/source/{sourceId}","href":"/api-reference/v1/switch/remove-source"}]},{"group":"Geolocation","pages":[{"title":"Geocode an Address","openapi":"GET /v1/geolocation","href":"/api-reference/v1/geolocation/get"},{"title":"Persist a Geolocation","openapi":"POST /v1/geolocation","href":"/api-reference/v1/geolocation/post"}]},{"group":"Location","pages":[{"title":"List Locations","openapi":"GET /v1/location","href":"/api-reference/v1/location/list"},{"title":"Get Location","openapi":"GET /v1/location/{uuid}","href":"/api-reference/v1/location/get"},{"title":"Create Location","openapi":"POST /v1/location","href":"/api-reference/v1/location/post"},{"title":"Update Location","openapi":"PATCH /v1/location/{uuid}","href":"/api-reference/v1/location/patch"},{"title":"Delete Location","openapi":"DELETE /v1/location/{uuid}","href":"/api-reference/v1/location/delete"}]},{"group":"Supplier","pages":[{"title":"List Suppliers","openapi":"GET /v1/supplier","href":"/api-reference/v1/supplier/list/get"},{"title":"Get Supplier","openapi":"GET /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/get"},{"title":"Create Supplier","openapi":"POST /v1/supplier","href":"/api-reference/v1/supplier/post"},{"title":"Edit Supplier","openapi":"PATCH /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/patch"},{"title":"Supplier Image","openapi":"PATCH /v1/supplier/{uuid}/image","href":"/api-reference/v1/supplier/image"},{"title":"Delete Supplier","openapi":"DELETE /v1/supplier/{uuid}","href":"/api-reference/v1/supplier/delete"}]},{"group":"Activity","pages":[{"title":"List Activities","openapi":"GET /v1/activity","href":"/api-reference/v1/activity/list"},{"title":"Get Activity","openapi":"GET /v1/activity/{uuid}","href":"/api-reference/v1/activity/get"},{"title":"Create Activity","openapi":"POST /v1/activity","href":"/api-reference/v1/activity/post"},{"title":"Update Activity","openapi":"PATCH /v1/activity/{uuid}","href":"/api-reference/v1/activity/patch"},{"title":"Delete Activity","openapi":"DELETE /v1/activity/{uuid}","href":"/api-reference/v1/activity/delete"},{"title":"Bulk Activity Creation","openapi":"POST /v1/activity/bulk","href":"/api-reference/v1/activity/bulk"},{"title":"Bulk Activity Deletion","openapi":"POST /v1/activity/bulk/delete","href":"/api-reference/v1/activity/bulk-delete"}]},{"group":"Activity Group","pages":[{"title":"List Activity Groups","openapi":"GET /v1/activity/group","href":"/api-reference/v1/activity-group/list"},{"title":"Get Activity Group","openapi":"GET /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/get"},{"title":"Create Activity Group","openapi":"POST /v1/activity/group","href":"/api-reference/v1/activity-group/post"},{"title":"Update Activity Group","openapi":"PATCH /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/patch"},{"title":"Delete Activity Group","openapi":"DELETE /v1/activity/group/{uuid}","href":"/api-reference/v1/activity-group/delete"}]},{"group":"Account","pages":[{"title":"List Accounts","openapi":"GET /v1/account","href":"/api-reference/v1/account/get"}]},{"group":"Org","pages":[{"title":"List Orgs","openapi":"GET /v1/org","href":"/api-reference/v1/org/get"}]},{"group":"Scope","pages":[{"title":"List Scopes","openapi":"GET /v1/scope","href":"/api-reference/v1/scope/get"}]},{"group":"Taxonomy","pages":[{"title":"List Taxonomies","openapi":"GET /v1/taxonomy","href":"/api-reference/v1/taxonomy/get"}]},{"group":"Unit","pages":[{"title":"List Units","openapi":"GET /v1/unit","href":"/api-reference/v1/unit/get"}]}]},{"tab":"PACT API","pages":[{"title":"PACT API","href":"/pact-api/welcome"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/welcome"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026"}]}]},"basePath":"","title":"List Switches - Variable API","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}