Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.
GET
/
datasource
Search Utility Providers
curl --request GET \
--url https://external.nectarclimate.com/v2.1/datasource \
--header 'X-API-KEY: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nectar Knowledge Base","colors":{"primary":"#092A54","light":"#3B82F6","dark":"#092A54"},"logo":{"light":"https://mintcdn.com/nectar/XTv6xdiQoWsCyg3G/logo/light.svg?fit=max\u0026auto=format\u0026n=XTv6xdiQoWsCyg3G\u0026q=85\u0026s=8b28e329f1aad1d1fbf3022d179cd34e","dark":"https://mintcdn.com/nectar/XTv6xdiQoWsCyg3G/logo/dark.svg?fit=max\u0026auto=format\u0026n=XTv6xdiQoWsCyg3G\u0026q=85\u0026s=12755083e4efe9b6e55b2f5bd4a71673"},"favicon":"https://mintcdn.com/nectar/XTv6xdiQoWsCyg3G/favicon.svg?fit=max\u0026auto=format\u0026n=XTv6xdiQoWsCyg3G\u0026q=85\u0026s=0442a8655f01c969dbb6dfb7a187d797","navbar":{"links":[{"href":"mailto:support@nectarclimate.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dash.nectarclimate.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/nectarclimate"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://dash.nectarclimate.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@nectarclimate.com"},{"anchor":"Status","icon":"signal","href":"https://stats.uptimerobot.com/rICwZ0oMLI"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nectar","hasAudioNarration":false,"actualSubdomain":"nectar","customDomains":["nectarclimate.com"],"gitSource":{"type":"github","owner":"project-pairly","repo":"nectar","deployBranch":"production","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad6d384536dd68dd9ccfac8","collectionId":"ff45001c-a2bb-4acf-a3b6-e7a83bf9339a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad6d384536dd68dd9ccfac8"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adff6624c95040b1f492aac","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":191},{"language":"default","tag":"Knowledge Base","count":153},{"language":"default","tag":"Data Input","count":58},{"language":"default","tag":"Utility-Specific MFA Guides","count":44},{"language":"default","tag":"Connections","count":27},{"language":"default","tag":"Usage Data","count":24},{"language":"default","tag":"Webhook Payloads","count":24},{"language":"default","tag":"Developer Guide","count":18},{"language":"default","tag":"Sites","count":18},{"language":"default","tag":"Meters","count":18}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2-1/connections/search-utility-providers","slug":"/api-reference/v2-1/connections/search-utility-providers","pageMetadata":{"title":"Search Utility Providers","description":"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as ``prefill.datasourceId`` when creating a connection invitation.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /datasource","href":"/api-reference/v2-1/connections/search-utility-providers","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as \", _jsx(_components.code, {\n children: \"prefill.datasourceId\"\n }), \" when creating a connection invitation.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search Utility Providers","description":"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as ``prefill.datasourceId`` when creating a connection invitation.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /datasource","href":"/api-reference/v2-1/connections/search-utility-providers","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"datasource_retrieve","description":"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as ``prefill.datasourceId`` when creating a connection invitation.","summary":"Search Utility Providers","parameters":["cea3f5bd-fab9-47eb-9b11-0dd512c590a9","aa795b76-f866-4c5d-bbb6-8836a4d3809e","f424ac5e-9df4-4c73-b0b7-00bdd3dafe66"],"tags":["Connections"],"security":["b9b6e5a8-441c-4fe2-b932-7b9faeb6f11f"],"responses":{"200":"b1ac4ec0-feeb-4dc5-a9de-ffa6eee7bbb6","400":"1eb1629c-11e0-4677-bf14-f5d2c8cfc698","403":"54eb6aa9-b506-42d1-b30a-b1fb0667ebeb"},"method":"get","type":"path","servers":["3c784457-d287-45bf-a196-1d18b2b71648"],"path":"/datasource","baseUrlOptions":["https://external.nectarclimate.com/v2.1"],"title":"Search Utility Providers","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"cea3f5bd-fab9-47eb-9b11-0dd512c590a9":{"in":"query","name":"page","schema":{"type":"integer","description":"Page number (default 1).","uniqueKey":"","typeLabel":"integer"},"description":"Page number (default 1)."},"aa795b76-f866-4c5d-bbb6-8836a4d3809e":{"in":"query","name":"pageSize","schema":{"type":"integer","description":"Items per page (default 100, max 500).","uniqueKey":"","typeLabel":"integer"},"description":"Items per page (default 100, max 500)."},"f424ac5e-9df4-4c73-b0b7-00bdd3dafe66":{"in":"query","name":"search","schema":{"type":"string","description":"Case-insensitive substring to match against the provider name or URL.","uniqueKey":"","typeLabel":"string"},"description":"Case-insensitive substring to match against the provider name or URL."}},"responses":{"b1ac4ec0-feeb-4dc5-a9de-ffa6eee7bbb6":{"content":{"application/json":{"schema":{"type":"object","description":"Paginated response envelope for the datasource search endpoint.","properties":{"totalDatasources":{"type":"integer","description":"Total number of matching utility providers.","isRequired":true,"uniqueKey":"totalDatasources","typeLabel":"integer"},"perPage":{"type":"integer","description":"Number of entries per page.","isRequired":true,"uniqueKey":"perPage","typeLabel":"integer"},"totalPages":{"type":"integer","description":"Total number of pages.","isRequired":true,"uniqueKey":"totalPages","typeLabel":"integer"},"currentPage":{"type":"integer","description":"Current page number.","isRequired":true,"uniqueKey":"currentPage","typeLabel":"integer"},"hasNext":{"type":"boolean","description":"Indicates if there is a next page.","isRequired":true,"uniqueKey":"hasNext","typeLabel":"boolean"},"hasPrevious":{"type":"boolean","description":"Indicates if there is a previous page.","isRequired":true,"uniqueKey":"hasPrevious","typeLabel":"boolean"},"datasources":{"type":"array","items":{"type":"object","description":"A utility provider known to Nectar that invitations can reference by ID.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the utility provider.","isRequired":true,"uniqueKey":"datasources.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Display name of the utility provider.","isRequired":true,"uniqueKey":"datasources.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","description":"Web address of the utility provider's customer portal.","isRequired":true,"uniqueKey":"datasources.items.[INDEX].url","typeLabel":"string"}},"required":["id","name","url"],"uniqueKey":"datasources.items.[INDEX]","typeLabel":"object"},"description":"List of utility providers.","isRequired":true,"uniqueKey":"datasources","typeLabel":"object[]"}},"required":["currentPage","datasources","hasNext","hasPrevious","perPage","totalDatasources","totalPages"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"totalDatasources":123,"perPage":123,"totalPages":123,"currentPage":123,"hasNext":true,"hasPrevious":true,"datasources":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","url":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"1eb1629c-11e0-4677-bf14-f5d2c8cfc698":{"content":{"application/json":{"schema":{"type":"object","description":"Serializer for error responses.","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"54eb6aa9-b506-42d1-b30a-b1fb0667ebeb":{"description":"Forbidden: invalid API key.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"b9b6e5a8-441c-4fe2-b932-7b9faeb6f11f":{"ExternalAuthentication":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[]}}},"servers":{"3c784457-d287-45bf-a196-1d18b2b71648":{"url":"https://external.nectarclimate.com/v2.1","description":"Nectar API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[]},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ExternalAuthentication","name":"X-API-KEY"}],"title":"ExternalAuthentication"}]},"originalFileLocation":"api-reference/openapi-v2-1.json"},"subdomain":"nectar","siteName":"Nectar Knowledge Base","title":"Search Utility Providers - Nectar Knowledge Base","navMaps":{"firstHrefInVersion":{"v2.2":{"href":"/api-reference/v2-2/connections/search-utility-providers","matchLevel":1},"v2.1":{"href":"/api-reference/v2-1/connections/search-utility-providers","matchLevel":0},"v2.0":{"href":"/api-reference/v2-0/connections/search-utility-providers","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T02:18:55.688Z","originalFileLocation":"api-reference/v2-1/connections/search-utility-providers.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=\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nectar Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_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=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search Utility Providers - Nectar Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nectar Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nectar.mintlify.app/_mintlify/api/og/v2?division=Connections\u0026amp;title=Search+Utility+Providers\u0026amp;description=Returns+a+paginated+list+of+utility+providers+in+the+Nectar+catalog.+Supports+case-insensitive+substring+search+on+name+and+URL.+Use+the+returned+ID+as+%60%60prefil\u0026amp;theme=d6f36af3d51813e1674f4062\u0026amp;signature=0df2ee467b29561c3be80f8e8cbb866c66372ef9b8440ed657c2ac3f25ec421c\">\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=\"Search Utility Providers - Nectar Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nectar.mintlify.app/_mintlify/api/og/v2?division=Connections\u0026amp;title=Search+Utility+Providers\u0026amp;description=Returns+a+paginated+list+of+utility+providers+in+the+Nectar+catalog.+Supports+case-insensitive+substring+search+on+name+and+URL.+Use+the+returned+ID+as+%60%60prefil\u0026amp;theme=d6f36af3d51813e1674f4062\u0026amp;signature=0df2ee467b29561c3be80f8e8cbb866c66372ef9b8440ed657c2ac3f25ec421c\">\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=\"/docs/mintlify-assets/_mintlify/favicons/nectar/gZW-eyAyHdprqGVs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nectar Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#092A54\">\u003clink data-mint-head rel=\"canonical\" href=\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/v2-1/connections/search-utility-providers.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://nectarclimate.com/#organization\",\"name\":\"Nectar Knowledge Base\",\"url\":\"https://nectarclimate.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nectar/XTv6xdiQoWsCyg3G/logo/light.svg?fit=max\u0026auto=format\u0026n=XTv6xdiQoWsCyg3G\u0026q=85\u0026s=8b28e329f1aad1d1fbf3022d179cd34e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://nectarclimate.com/docs#website\",\"name\":\"Nectar Knowledge Base\",\"url\":\"https://nectarclimate.com/docs\",\"publisher\":{\"@id\":\"https://nectarclimate.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers#webpage\",\"url\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers\",\"name\":\"Search Utility Providers\",\"description\":\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.\",\"dateModified\":\"2026-09-29T02:18:55.688Z\",\"isPartOf\":{\"@id\":\"https://nectarclimate.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connections\",\"item\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/create-magic-link-for-updating-a-utility-account-connection\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search Utility Providers\",\"item\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers#apireference\",\"headline\":\"Search Utility Providers\",\"name\":\"Search Utility Providers\",\"description\":\"Returns a paginated list of utility providers in the Nectar catalog. Supports case-insensitive substring search on name and URL. Use the returned ID as prefill.datasourceId when creating a connection invitation.\",\"url\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers\",\"mainEntityOfPage\":{\"@id\":\"https://nectarclimate.com/docs/api-reference/v2-1/connections/search-utility-providers#webpage\"},\"dateModified\":\"2026-09-29T02:18:55.688Z\",\"publisher\":{\"@id\":\"https://nectarclimate.com/#organization\"},\"isPartOf\":{\"@id\":\"https://nectarclimate.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nectar Knowledge Base\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nectar Knowledge Base","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://dash.nectarclimate.com"},{"anchor":"Support","icon":"envelope","href":"mailto:support@nectarclimate.com"},{"anchor":"Status","icon":"signal","href":"https://stats.uptimerobot.com/rICwZ0oMLI"}]},"tabs":[{"tab":"Knowledge Base","pages":[{"title":"Knowledge Base","href":""}]},{"tab":"Developer Guide","pages":[{"title":"Developer Guide","href":"/developer-guide/for-developers"}]},{"tab":"API Reference","versions":[{"version":"v2.2","pages":[{"title":"v2.2","href":"/api-reference/v2-2/connections/search-utility-providers"}]},{"version":"v2.1","groups":[{"group":"Accounts","pages":[{"title":"Update an account","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /account/{account_id}","href":"/api-reference/v2-1/accounts/update-an-account"},{"title":"Bulk update accounts for a company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /account/bulk","href":"/api-reference/v2-1/accounts/bulk-update-accounts-for-a-company"}]},{"group":"Companies","pages":[{"title":"Retrieve Companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /company","href":"/api-reference/v2-1/companies/retrieve-companies"},{"title":"Create Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /company","href":"/api-reference/v2-1/companies/create-company"},{"title":"Get Company Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /company/{company_id}","href":"/api-reference/v2-1/companies/get-company-details"},{"title":"Delete Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json delete /company/{company_id}","href":"/api-reference/v2-1/companies/delete-company"},{"title":"Update Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /company/{company_id}","href":"/api-reference/v2-1/companies/update-company"}]},{"group":"Webhook Portal","pages":[{"title":"Get Webhook Settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /configure_webhook","href":"/api-reference/v2-1/webhook-portal/get-webhook-settings"},{"title":"Webhook Portal","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /configure_webhook","href":"/api-reference/v2-1/webhook-portal/webhook-portal"},{"title":"Update Webhook Settings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /configure_webhook","href":"/api-reference/v2-1/webhook-portal/update-webhook-settings"}]},{"group":"Connections","pages":[{"title":"Create Magic Link for Updating a Utility Account Connection","deprecated":true,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /connection/{connection_id}","href":"/api-reference/v2-1/connections/create-magic-link-for-updating-a-utility-account-connection"},{"title":"Get an Utility Account Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /connection/{connection_id}/details","href":"/api-reference/v2-1/connections/get-an-utility-account-connection"},{"title":"Update an Utility Account Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /connection/{connection_id}/details","href":"/api-reference/v2-1/connections/update-an-utility-account-connection"},{"title":"Confirm a utility account connection for a company.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /connection/{connection_id}/status","href":"/api-reference/v2-1/connections/confirm-a-utility-account-connection-for-a-company"},{"title":"Get Company Utility Account Connections","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /connection/company/{company_id}","href":"/api-reference/v2-1/connections/get-company-utility-account-connections"},{"title":"Create Basic Utility Account Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /connection/company/{company_id}","href":"/api-reference/v2-1/connections/create-basic-utility-account-connection"},{"title":"Create Magic Link for Creating a Utility Account Connection","deprecated":true,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /connection/company/{company_id}/link","href":"/api-reference/v2-1/connections/create-magic-link-for-creating-a-utility-account-connection"},{"title":"Create Magic Link with Prefilled Data for Creating a Utility Account Connection","description":"**Deprecated:** Use `POST /invitation/company/{company_id}` with the `prefill` field instead. This endpoint will be removed in a future API version.\n\nGenerates a Nectar signed secret for a specific company with optional prefilled data. This endpoint allows you to optionally pre-populate fields in the connection form. Also allows you to optionally set an expiration time for the magic link.","deprecated":true,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /connection/company/{company_id}/link","href":"/api-reference/v2-1/connections/create-magic-link-with-prefilled-data-for-creating-a-utility-account-connection"},{"title":"Search Utility Providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /datasource","href":"/api-reference/v2-1/connections/search-utility-providers"}]},{"group":"Documents","pages":[{"title":"Get Document Details","description":"Retrieve detailed information about a specific document by its document ID. Users must have access to the company that owns the document to retrieve this data. Response includes document usage data, associated site information, presigned S3 URL to view the document, audit trail URL to view the edit history, and utility company name.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /document/{document_id}","href":"/api-reference/v2-1/documents/get-document-details"},{"title":"Update Document Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /document/{document_id}","href":"/api-reference/v2-1/documents/update-document-details"},{"title":"Get Demand Meters by Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /document/{document_id}/demandmeters","href":"/api-reference/v2-1/documents/get-demand-meters-by-document"},{"title":"Get Documents by Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /document/company/{company_id}","href":"/api-reference/v2-1/documents/get-documents-by-company"},{"title":"Get Documents by Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /document/connection/{connection_id}","href":"/api-reference/v2-1/documents/get-documents-by-connection"},{"title":"Get Documents by Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /document/site/{site_id}","href":"/api-reference/v2-1/documents/get-documents-by-site"}]},{"group":"Intervals","pages":[{"title":"Get Intervals by Connection (BETA)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /interval/connection/{connection_id}","href":"/api-reference/v2-1/intervals/get-intervals-by-connection-beta"}]},{"group":"Invitations","pages":[{"title":"Get Invitation Detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /invitation/{invitation_id}","href":"/api-reference/v2-1/invitations/get-invitation-detail"},{"title":"Revoke Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /invitation/{invitation_id}/revoke","href":"/api-reference/v2-1/invitations/revoke-invitation"},{"title":"List Invitations by Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /invitation/company/{company_id}","href":"/api-reference/v2-1/invitations/list-invitations-by-company"},{"title":"Create Connection Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /invitation/company/{company_id}","href":"/api-reference/v2-1/invitations/create-connection-invitation"},{"title":"Create Reconnect Invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /invitation/connection/{connection_id}","href":"/api-reference/v2-1/invitations/create-reconnect-invitation"}]},{"group":"Jobs","pages":[{"title":"Get Job Status Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /job/{job_id}","href":"/api-reference/v2-1/jobs/get-job-status-details"},{"title":"Submit Job via Single Document Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /job/company/{company_id}","href":"/api-reference/v2-1/jobs/submit-job-via-single-document-upload"},{"title":"Submit Job via Bulk Document Upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /job/company/{company_id}/bulk","href":"/api-reference/v2-1/jobs/submit-job-via-bulk-document-upload"}]},{"group":"Meters","pages":[{"title":"Get Meter Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /meter/{meter_id}","href":"/api-reference/v2-1/meters/get-meter-details"},{"title":"Update Meter Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /meter/{meter_id}","href":"/api-reference/v2-1/meters/update-meter-details"},{"title":"Get Meters by Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /meter/company/{company_id}","href":"/api-reference/v2-1/meters/get-meters-by-company"},{"title":"Get Meters by Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /meter/connection/{connection_id}","href":"/api-reference/v2-1/meters/get-meters-by-connection"},{"title":"Get Meters by Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /meter/document/{document_id}","href":"/api-reference/v2-1/meters/get-meters-by-document"},{"title":"Get Meters by Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /meter/site/{site_id}","href":"/api-reference/v2-1/meters/get-meters-by-site"}]},{"group":"Ping","pages":[{"title":"Ping Test Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /ping","href":"/api-reference/v2-1/ping/ping-test-endpoint"}]},{"group":"Sites","pages":[{"title":"Get Site Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /site/{site_id}","href":"/api-reference/v2-1/sites/get-site-details"},{"title":"Delete Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json delete /site/{site_id}","href":"/api-reference/v2-1/sites/delete-site"},{"title":"Update Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /site/{site_id}","href":"/api-reference/v2-1/sites/update-site"},{"title":"Get Sites by Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /site/company/{company_id}","href":"/api-reference/v2-1/sites/get-sites-by-company"},{"title":"Create Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json post /site/company/{company_id}","href":"/api-reference/v2-1/sites/create-site"}]},{"group":"Team","pages":[{"title":"Get Team and Billing Information","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /team","href":"/api-reference/v2-1/team/get-team-and-billing-information"},{"title":"Update Team and Billing Information","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /team","href":"/api-reference/v2-1/team/update-team-and-billing-information"}]},{"group":"Usage Data","pages":[{"title":"Get Usage Data Details","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/{usage_data_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-details"},{"title":"Delete Usage Data","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json delete /usage/{usage_data_id}","href":"/api-reference/v2-1/usage-data/delete-usage-data"},{"title":"Update Usage Data","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json patch /usage/{usage_data_id}","href":"/api-reference/v2-1/usage-data/update-usage-data"},{"title":"Get Usage Data by Company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/company/{company_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-by-company"},{"title":"Get Usage Data by Utility Connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/connection/{connection_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-by-utility-connection"},{"title":"Get Usage Data by Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/document/{document_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-by-document"},{"title":"Get Usage Data by Meter","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/meter/{meter_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-by-meter"},{"title":"Get Usage Data by Site","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2-1.json get /usage/site/{site_id}","href":"/api-reference/v2-1/usage-data/get-usage-data-by-site"}]},{"group":"Webhook Payloads","pages":[{"title":"Webhook for utility account connection creation v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook connection.created.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-utility-account-connection-creation-v2"},{"title":"Webhook for updates to an existing utility account connection v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook connection.updated.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-updates-to-an-existing-utility-account-connection-v2"},{"title":"Webhook for connection status changes v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook connection.validated.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-connection-status-changes-v2"},{"title":"Webhook for new document availability v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook document.created.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-new-document-availability-v2"},{"title":"Webhook for document update v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook document.updated.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-document-update-v2"},{"title":"Webhook for document deletion v2","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook document.deleted.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-document-deletion-v2"},{"title":"Webhook for synced interval data","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook intervals.synced","href":"/api-reference/v2-1/webhook-payloads/webhook-for-synced-interval-data"},{"title":"Webhook for document upload job completion","version":null,"deprecated":null,"openapi":"/api-reference/openapi-v2-1.json webhook job.completed.v2","href":"/api-reference/v2-1/webhook-payloads/webhook-for-document-upload-job-completion"}]}]},{"version":"v2.0","pages":[{"title":"v2.0","href":"/api-reference/v2-0/connections/search-utility-providers"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Search Utility Providers - Nectar Knowledge Base","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bg4Z7D_G.js","utils-Biz734EK.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6F9YHs6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BoJjY_VP.js","snippetPresets-CnZ-mOFh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DC_SB2pp.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BYKtOiIP.js","shallow-COAac_UD.js","getApiPlaygroundDisplay-BV4Viqi2.js","CodeSnippet-DDgW-JXl.js","CodeSnippets-CP1LpNhG.js","Page-BeiUfucV.js","getPastedJson-Cvgvbfmv.js","icon-D-H368xH.js","MethodPill-CXSxH1VW.js","DuplicateIcon-JcbBzF1x.js","createIcon-BDt_aHZM.js","DynamicMarkdown-DO1Fz7ar.js","SectionHeading-mwKBArs3.js","axios-vUo_bRtp.js","Markdown-C3KUTGJN.js","clsx-C6CAjViH.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C3vb5JQZ.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C8Hisf3g.js"]}