The Programs API provides endpoints for discovering, retrieving, and managing energy and technology incentive programs across various states, sectors, and categories. It is designed to support applications that need to search, filter, and display program data for utilities, implementers, researchers, and the public.
\nThis API is organized around REST and tends to follow a predictable resource-oriented URL structure. All responses from this api will be in JSON-encoded format. The API uses standard HTTP response codes, authentication, and verbs. This API is READ-ONLY at this time. Should you need to request a change or correction, please contact: dsire-admin@ncsu.edu
\nFor reference, you can also visit the companion website: https://programs.dsireusa.org/system/program
\nTo get started using the DSIRE Programs API, read the information in this section.
\nYou need a valid API Key to send requests to the API endpoints.
\nThe API has rate and usage limits.
\nThe API only responds to HTTPS-secured communications. Any requests sent via HTTP return an HTTP 301 redirect to the corresponding HTTPS resources.
\nThe API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key.
\nThe requests reference environment variables that can be safely stored and reused across the entire workspace. To start calling the endpoints, create an environment variable for each of the following:
\nBrowse and search for incentive programs by state, technology, sector, utility, and other filters.
\nRetrieve detailed information about specific programs, including eligibility, technologies, and contacts.
\nIntegrate program data into web portals, dashboards, or research tools.
\nThe API enforces pagination via limit and offset parameters to control the result set size.
Rate limits may apply to prevent abuse or based on a contractual agreement; excessive requests may be throttled or blocked.
\nFor optimal performance, use appropriate filters and avoid requesting large unpaginated result sets.
\nMost endpoints return data in a consistent envelope structure:
\n{\n \"data\": [ /* array or object with results */ ],\n \"meta\": {\n \"total\": /* Total result from the endpoint based on filters applied*/,\n \"limit\": /* Maximum number of results returned by the endpoint */,\n \"offset\": /* Pagination offset indicated results skipped from starting page */,\n },\n \"message\": \"Optional informational or error message\"\n}\n\nThe API requires an API Key for unrestricted access. In order to become a partner and utilize the API you must have a valid API key.
\nYour API key should not be shared publicly or with unauthorized parties. The key is a secret and should be kept secure to prevent abuse of the platform. Never use your API Key on a public client.
\nAll API requests must be made over HTTPS. HTTP requests are not supported and will be redirected to their HTTPS equivalent.
\n\n\n⚠️ Keep your API key secure. Never expose it in client-side code.
\n
The Program API is subject to versioning to ensure backward compatibility and smooth transitions as new features or changes are introduced. Always specify the desired API version in your requests, via the URL path (e.g., /v1/programs). Review the API changelog and documentation regularly to stay informed about deprecations, breaking changes, and new capabilities.
The API enforces pagination via limit and offset parameters to control the result set size.
See Programs Overview for more information about the programs endpoint. Use the links in the Query Parameters table to explore the reference data endpoints for filtering.
\nGET request to retrieve a list of all programs from the DSIRE Programs API. Requires the 'baseUrl' and 'apiKey' variables to be set.
\nHits the endpoint: {{baseUrl}}/programs
Supports pagination through the limit and offset query parameters to control the number of results and starting point.
Usage Notes:
\nDiscover available filters by visiting the endpoints in the Reference Data collection folder. Examples include:
\nGeographic filters are listed under Geographic Data and Utilities sub-folders.
\nUse the List Programs by state(s) endpoint to test combining multiple geographic filters.
\nSummary:
\nRetrieves detailed information about a specific program from the DSIRE Programs API by its unique ID. This endpoint requires the baseUrl and apiKey variables to be set in the environment.
Path Variables:
\nid (required): The unique identifier of the program to retrieve.Example:
\ncurl -X GET \"{{baseUrl}}/programs/index/:id\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\n(Required)
\n","type":"text/plain"},"type":"any","value":"1","key":"id"}]}},"response":[{"id":"ae9e152b-12f3-4e10-b8f9-a83352f58feb","name":"Get program details example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.dsireusa.org/v1/programs/index/:id","protocol":"https","host":["api","dsireusa","org"],"path":["v1","programs","index",":id"],"variable":[{"key":"id","value":"1","description":"(Required)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate, post-check=0, pre-check=0"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Thu, 25 Sep 2025 02:50:07 GMT"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Pragma","value":"no-cache"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=15552000"},{"key":"Strict-Transport-Security","value":"max-age=15552000"},{"key":"Vary","value":"Accept-Encoding,User-Agent"},{"key":"X-Powered-By","value":"PHP/5.6.31"},{"key":"Content-Length","value":"1946"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1,\n \"entireState\": true,\n \"state\": 1,\n \"stateObj\": {\n \"id\": 1,\n \"name\": \"New York\",\n \"abbreviation\": \"NY\",\n \"is_territory\": false\n },\n \"type\": 1,\n \"typeObj\": {\n \"id\": 1,\n \"name\": \"Type 1\",\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Category 1\"\n }\n },\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Category 1\"\n },\n \"sector\": 1,\n \"sectorObj\": {\n \"id\": 1,\n \"name\": \"State\",\n \"active\": true\n },\n \"code\": \"CODE123\",\n \"name\": \"New York Solar/Wind Easements and Laws\",\n \"websiteUrl\": \"https://www.test.com/\",\n \"administrator\": null,\n \"fundingSource\": null,\n \"budget\": null,\n \"startDate\": \"\",\n \"startDateDisplay\": null,\n \"startDateText\": null,\n \"endDate\": \"\",\n \"endDateDisplay\": null,\n \"endDateText\": null,\n \"summary\": \"Lorem Ipsum
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam viverra mauris non diam aliquam, id condimentum quam pellentesque. Nam volutpat, justo quis lobortis euismod;
Summary:
Retrieve a list of programs filtered by one or more state IDs. This endpoint allows you to fetch programs available in specific states, with support for multiple state filters and pagination.
Query Parameters:
\nstate[]: accepts numeric ID or character code. Programs filtered by state include federal programs by default.
limit (optional): Number of results to return per request (pagination limit). Default: 10.
offset (optional): Number of results to skip before starting to collect the result set (pagination offset). Default: 0.
Usage Notes:
\nUse /states to find valid numeric state IDs.
\nSend each state ID or character code as a separate query parameter (e.g., state[]=1&state[]=CA).
To filter by state, you can use either the numeric ID (e.g., state[]=6) or the USPS/ANSI two-character code (e.g., state[]=CA)
Send each state ID or character code as a separate query parameter (e.g., state[]=1&state[]=CA).
State filters include federal territories by default.
\nYou can further filter by coverage areas, including: utility[], zipcode[], city[], and county[]. Use the Geographic Data endpoints to find valid IDs for geographic filters.
zipcode[] parameter accepts IDs (and not the 5 digit zip code). Use /zipcodes to find valid IDs
Example Request:
\nGET {{baseUrl}}/programs?state[]=1&state[]=2&limit=10&offset=0\n\nThis example fetches up to 10 state programs available in states with IDs 1 and 2, starting from the first result.
\n","auth":{"type":"apikey","apikey":{"value":"{{apiKey}}","key":"Summary:
\nThis GET request retrieves programs filtered by technology category. Use this request to efficiently fetch targeted program data by specifying relevant categories and pagination settings.
\nUsage Notes:
\nSupports pagination through the 'limit' and 'offset' query parameters to control the number of results and starting point
\ntechnologycategory[] parameter filters programs by specific technology category IDs
Use /technology-categories to find valid IDs for filtering.
\nUse category ID from /technology-categories endpoint
\n","type":"text/plain"},"key":"technologycategory[]","value":"1"},{"description":{"content":"Integer value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Summary:
\nThis GET request retrieves programs filtered by sector. Use this request to efficiently fetch targeted program data by specifying sector ID and/or implementing sector ID and pagination settings.
\nUsage Notes:
\nSupports pagination through the 'limit' and 'offset' query parameters to control the number of results and starting point
\nsector[] and implementing-sector[] filters programs by specific sector IDs
Use /sectors and /implementing-sectors to find valid sector IDs.
\nSummary:
\nThis GET request retrieves programs filtered by category ID. Use this request to efficiently fetch targeted program data by specifying relevant categories and pagination settings.
\nUsage Notes:
\nSupports pagination through the 'limit' and 'offset' query parameters to control the number of results and starting point
\ncategory[] parameter filters programs by specific technology category IDs
Use /categories to find valid IDs for filtering
\nUse category ID from /categories endpoint
\n","type":"text/plain"},"key":"category[]","value":"1"},{"description":{"content":"Integer value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Summary:
\nThis GET request retrieves programs filtered by incentive type category. Use this request to efficiently fetch targeted program data by specifying type and pagination settings.
\nUsage Notes:
\nSupports pagination through the limit and offset query parameters to control the number of results and starting point
Use /types endpoint to find valid Program Type IDs for filtering
\nUse type ID from /types endpoint
\n","type":"text/plain"},"key":"type[]","value":"13"},{"description":{"content":"Integer value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Summary:
\nRetrieves a list of programs filtered by energy category
\nIt supports pagination through the limit and offset query parameters, allowing control over the number of results returned and the starting point in the dataset.
The energycategory[] parameter accepts one or more energy category IDs to filter programs relevant to those categories.
Usage notes:
\nlimit controls the maximum number of programs returned (default is 10, max is 500).
offset specifies the starting index for results, useful for paginating through large datasets
energycategory[] can be provided multiple times to include multiple categories in the filter
Use /energy-categories to find valid energy category IDs for filtering
\nUse energy category ID from /energy-categories endpoint
\n","type":"text/plain"},"key":"energycategory[]","value":"1"},{"description":{"content":"Integer value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Use the expiredto[] and expiredfrom[] query params to filter programs by expiration date.
Use updatedto[] to get programs Updated Before the date provided
Use updatedfrom[] to get programs Updated After the date provided
\n\nNOTE: A pre-request script automatically converts the ISO date to the encoded date format accepted by the API. Hover over the {{isoDate}} query params to edit the environment variables directly from the request. Make sure to hit
\nReturnto save the date!
You can use the query params individually or together
\nDouble-check the date range entered, especially when using both to and from dates.
\nMake sure to include the brackets
\nInteger value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Updated After: {date}
\n","type":"text/plain"},"key":"updatedfrom[]","value":"{{isoDateFrom}}"},{"description":{"content":"Updated Before: {date}
\n","type":"text/plain"},"key":"updatedto[]","value":"{{isoDateTo}}"}],"variable":[]}},"response":[{"id":"1ab88830-035f-414a-81e6-79522f62d639","name":"Get programs by updated date example","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/programs?limit=50&offset=0&updatedto[]={{isoDateTo}}","host":["{{baseUrl}}"],"path":["programs"],"query":[{"key":"limit","value":"50","description":"Integer value (e.g., `25`). Maximum number of results to return per page. "},{"key":"offset","value":"0","description":"Integer value (e.g., `50`). Number of results to skip before starting the page."},{"key":"updatedfrom[]","value":"{{isoDateFrom}}","description":"Updated After: {date}","disabled":true},{"key":"updatedto[]","value":"{{isoDateTo}}","description":"Updated Before: {date}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 Jan 2026 04:56:45 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"196536"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"eda4271e-9977-4837-b2cd-422f59f2d739"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"x-amzn-Remapped-Connection","value":"keep-alive"},{"key":"Set-Cookie","value":"AWSALB=SLIsr7EY3zh2JIpkxOYmNMmqfQ5DC+U0kwYxWZfULobb6foPIEEmai9MnhaIs3Vx4FXkC2n9Hc/4CMSkoQB62hi2hX2xahdptsFnes6wgsSWkvSIW1WWDSRQqdJB; Expires=Wed, 21 Jan 2026 04:56:44 GMT; Path=/"},{"key":"Set-Cookie","value":"AWSALBCORS=SLIsr7EY3zh2JIpkxOYmNMmqfQ5DC+U0kwYxWZfULobb6foPIEEmai9MnhaIs3Vx4FXkC2n9Hc/4CMSkoQB62hi2hX2xahdptsFnes6wgsSWkvSIW1WWDSRQqdJB; Expires=Wed, 21 Jan 2026 04:56:44 GMT; Path=/; SameSite=None; Secure"},{"key":"x-amz-apigw-id","value":"XKJCEFRUoAMEN2Q="},{"key":"Vary","value":"Origin"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate, post-check=0, pre-check=0"},{"key":"x-amzn-Remapped-Server","value":"nginx/1.14.2"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"X-Powered-By","value":"PHP/5.6.40"},{"key":"Access-Control-Expose-Headers","value":"X-CSRF-Token"},{"key":"Pragma","value":"no-cache"},{"key":"x-amzn-Remapped-Date","value":"Wed, 14 Jan 2026 04:56:45 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1234,\n \"entireState\": true,\n \"state\": 12,\n \"stateObj\": {\n \"id\": 12,\n \"name\": \"Example State\",\n \"abbreviation\": \"EX\",\n \"is_territory\": false\n },\n \"type\": 45,\n \"typeObj\": {\n \"id\": 45,\n \"name\": \"Rebate Program\",\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Financial Incentive\"\n }\n },\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Financial Incentive\"\n },\n \"sector\": 3,\n \"sectorObj\": {\n \"id\": 3,\n \"name\": \"Utility\",\n \"active\": true\n },\n \"name\": \"Example Energy Efficiency Rebate\",\n \"websiteUrl\": \"https://example-utility.com/rebate\",\n \"administrator\": \"Example Utility Company\",\n \"summary\": \"Customers can receive rebates for installing qualified energy-efficient equipment. Incentive amounts vary by equipment type and capacity.\",\n \"published\": \"Yes\",\n \"updatedTs\": \"2025-01-15\",\n \"lastUpdated\": \"January 15, 2025\",\n \"createdTs\": \"2024-05-01\",\n \"parameterSets\": [\n {\n \"id\": 501,\n \"programId\": 1234,\n \"parameters\": [\n {\n \"source\": \"Incentive\",\n \"qualifier\": \"max\",\n \"amount\": \"500.00\",\n \"units\": \"$\",\n \"id\": 9001\n }\n ],\n \"technologies\": [\n {\n \"id\": 210,\n \"name\": \"Solar PV\",\n \"category\": \"Renewable Energy\",\n \"categoryId\": 2,\n \"energyCategoryId\": 1\n }\n ],\n \"sectors\": [\n {\n \"id\": 9,\n \"name\": \"Residential\",\n \"parentId\": 29,\n \"selectable\": true\n }\n ]\n }\n ],\n \"details\": [\n {\n \"id\": 301,\n \"label\": \"Maximum Incentive\",\n \"value\": \"$500 per installation\",\n \"displayOrder\": 0,\n \"templateId\": 60\n },\n {\n \"id\": 302,\n \"label\": \"Eligible Equipment\",\n \"value\": \"ENERGY STAR certified appliances and solar equipment\",\n \"displayOrder\": 1,\n \"templateId\": 61\n }\n ]\n }\n ],\n \"meta\": {\n \"total\": 12345,\n \"limit\": 10,\n \"offset\": 0,\n \"tag\": \"programs\"\n },\n \"draw\": null,\n \"recordsTotal\": 12345,\n \"recordsFiltered\": 12345\n}"}],"_postman_id":"6b12d4ad-9655-4d89-bc8e-4df35856f39b"},{"name":"Get programs by expiration date","event":[{"listen":"prerequest","script":{"id":"cb5d2740-ab56-4add-b8b2-16ca884ef4ad","exec":["/**"," * Converts ISO 8601 date (YYYY-MM-DD) to a URL-encoded natural date string"," * Example: 2025-10-01 → Thu%20Oct%2001%202025"," */","","let isoDate = pm.variables.get(\"isoDate\") || \"2025-10-01\"; // fallback for demo","","// Convert ISO string to Date object","let dateObj = new Date(isoDate);","","// Create natural string like \"Thu Oct 01 2025\"","let naturalDate = dateObj.toDateString(); // e.g. \"Thu Oct 02 2025\"","","// URL-encode it so spaces become %20","let encodedDate = encodeURIComponent(naturalDate);","","// Save it as a new variable","pm.collectionVariables.set(\"encodedDate\", encodedDate);","","// Log result for visibility","console.log(\"Encoded date:\", encodedDate);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"10af55f1-3e31-49e7-8744-6e8fe43ece0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/programs?limit=50&offset=0&expiredfrom[]={{isoDateFrom}}","description":"Use the expiredto[] and expiredfrom[] query params to filter programs by expiration date.
Use expiredto[] to get programs that Expire Before the date provided
Use expiredfrom[] to get programs that Expire After the date provided
\n\nNOTE: A pre-request script automatically converts the ISO date to the encoded date format accepted by the API. Hover over the {{isoDate}} query params to edit the environment variables directly from the request. Make sure to hit
\nReturnto save the date!
You can use the query params individually or together
\nDouble-check the date range entered, especially when using both to and from dates.
\nMake sure to include the brackets
\nInteger value (e.g., 25). Maximum number of results to return per page.
Integer value (e.g., 50). Number of results to skip before starting the page.
Expires after: {date}
\n","type":"text/plain"},"key":"expiredfrom[]","value":"{{isoDateFrom}}"},{"disabled":true,"description":{"content":"Expires before: {date}
\n","type":"text/plain"},"key":"expiredto[]","value":"{{isoDateTo}}"}],"variable":[]}},"response":[{"id":"713237d6-aaec-4338-b39b-da118aa7ff18","name":"Get programs by expiration date example","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/programs?limit=50&offset=0&expiredto[]={{isoDateTo}}","host":["{{baseUrl}}"],"path":["programs"],"query":[{"key":"limit","value":"50","description":"Integer value (e.g., `25`). Maximum number of results to return per page. "},{"key":"offset","value":"0","description":"Integer value (e.g., `50`). Number of results to skip before starting the page."},{"key":"expiredto[]","value":"{{isoDateTo}}","description":"Expires before: {date} "},{"key":"expiredfrom[]","value":"{{isoDateFrom}}","description":"Expires after: {date}","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 14 Jan 2026 04:57:28 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Content-Length","value":"11363"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"f5758d4f-2b1b-4e0e-91d7-21d13f018747"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"x-amzn-Remapped-Connection","value":"keep-alive"},{"key":"Set-Cookie","value":"AWSALB=9e2Inb4nKBBFapdFujI7r5PdDd7MnTNh/xpbXimN4/k0UPXlhHaGJWXVvv+62CMqpHbEmzpBtpLS5E3TLPaUq+ZIxBid9HRT7RHVL+y7i4wvnbpEwTzJaN+SpOTc; Expires=Wed, 21 Jan 2026 04:57:28 GMT; Path=/"},{"key":"Set-Cookie","value":"AWSALBCORS=9e2Inb4nKBBFapdFujI7r5PdDd7MnTNh/xpbXimN4/k0UPXlhHaGJWXVvv+62CMqpHbEmzpBtpLS5E3TLPaUq+ZIxBid9HRT7RHVL+y7i4wvnbpEwTzJaN+SpOTc; Expires=Wed, 21 Jan 2026 04:57:28 GMT; Path=/; SameSite=None; Secure"},{"key":"x-amz-apigw-id","value":"XKJI3G1xIAMEAvA="},{"key":"Vary","value":"Origin"},{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate, post-check=0, pre-check=0"},{"key":"x-amzn-Remapped-Server","value":"nginx/1.14.2"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"X-Powered-By","value":"PHP/5.6.40"},{"key":"Access-Control-Expose-Headers","value":"X-CSRF-Token"},{"key":"Pragma","value":"no-cache"},{"key":"x-amzn-Remapped-Date","value":"Wed, 14 Jan 2026 04:57:28 GMT"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1234,\n \"entireState\": true,\n \"state\": 12,\n \"stateObj\": {\n \"id\": 12,\n \"name\": \"Example State\",\n \"abbreviation\": \"EX\",\n \"is_territory\": false\n },\n \"type\": 45,\n \"typeObj\": {\n \"id\": 45,\n \"name\": \"Rebate Program\",\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Financial Incentive\"\n }\n },\n \"category\": 1,\n \"categoryObj\": {\n \"id\": 1,\n \"name\": \"Financial Incentive\"\n },\n \"sector\": 3,\n \"sectorObj\": {\n \"id\": 3,\n \"name\": \"Utility\",\n \"active\": true\n },\n \"name\": \"Example Energy Efficiency Rebate\",\n \"websiteUrl\": \"https://example-utility.com/rebate\",\n \"administrator\": \"Example Utility Company\",\n \"summary\": \"Customers can receive rebates for installing qualified energy-efficient equipment. Incentive amounts vary by equipment type and capacity.\",\n \"published\": \"Yes\",\n \"updatedTs\": \"2025-01-15\",\n \"lastUpdated\": \"January 15, 2025\",\n \"createdTs\": \"2024-05-01\",\n \"parameterSets\": [\n {\n \"id\": 501,\n \"programId\": 1234,\n \"parameters\": [\n {\n \"source\": \"Incentive\",\n \"qualifier\": \"max\",\n \"amount\": \"500.00\",\n \"units\": \"$\",\n \"id\": 9001\n }\n ],\n \"technologies\": [\n {\n \"id\": 210,\n \"name\": \"Solar PV\",\n \"category\": \"Renewable Energy\",\n \"categoryId\": 2,\n \"energyCategoryId\": 1\n }\n ],\n \"sectors\": [\n {\n \"id\": 9,\n \"name\": \"Residential\",\n \"parentId\": 29,\n \"selectable\": true\n }\n ]\n }\n ],\n \"details\": [\n {\n \"id\": 301,\n \"label\": \"Maximum Incentive\",\n \"value\": \"$500 per installation\",\n \"displayOrder\": 0,\n \"templateId\": 60\n },\n {\n \"id\": 302,\n \"label\": \"Eligible Equipment\",\n \"value\": \"ENERGY STAR certified appliances and solar equipment\",\n \"displayOrder\": 1,\n \"templateId\": 61\n }\n ]\n }\n ],\n \"meta\": {\n \"total\": 12345,\n \"limit\": 10,\n \"offset\": 0,\n \"tag\": \"programs\"\n },\n \"draw\": null,\n \"recordsTotal\": 12345,\n \"recordsFiltered\": 12345\n}"}],"_postman_id":"10af55f1-3e31-49e7-8744-6e8fe43ece0e"}],"id":"e564f9c9-c99f-406f-aa70-b8254a956d3f","description":"The Programs endpoints return comprehensive information about energy programs and policies, including incentives, rebates, and regulatory frameworks.
\nUse this folder to:
\nList all available programs.
\nRetrieve detailed information about specific programs.
\nFilter programs by geographical location, sector, category, type, or technology.
\nGET /programs
Returns a list of program records with optional filters sent as query params.
\n{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example Energy Rebate Program\",\n \"stateObj\": { \"id\": 1, \"name\": \"Example State\", \"abbreviation\": \"EX\" },\n \"categoryObj\": { \"id\": 1, \"name\": \"Incentive\" },\n \"typeObj\": { \"id\": 1, \"name\": \"Program\" },\n \"summary\": \"<p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>Short example program summary.</p>\",\n \"websiteUrl\": \"https://api.example.com/programs/1\",\n \"lastUpdated\": \"October 6, 2025\"\n }\n ],\n \"meta\": { \"total\": 1, \"limit\": 5, \"offset\": 0 }\n}\n\nUse meta.total to determine pagination.
Combine filters for precise queries.
\nThe field summary may include basic HTML formatting.
The States endpoints return a list of U.S. states and territories. These reference IDs are used throughout other endpoints, such as /programs.
Useful for mapping state.id values in program results.
IDs are stable and not expected to change.
\nThe Counties endpoint returns a list of U.S. counties. These reference IDs are used throughout other endpoints such as /programs.
Useful for mapping county.id values in program results or for building geographic filters.
Use optional state parameter to filter results by a particular state.
IDs are stable and not expected to change.
\nGeographic datasets are static and updated periodically.
\nThe Cities endpoint returns a list of U.S. cities. These reference IDs are used throughout other endpoints such as /programs.
Useful for mapping city.id values in program results or for building geographic filters.
Use optional state or county parameters to filter results by a particular state or county.
IDs are stable and not expected to change.
\nGeographic datasets are static and updated periodically.
\nThe Zipcodes endpoint returns a list of 5-digit zipcodes and some related geographic information for that Zipcode. The 5-digit zip code is returned under the \"name\" property. Other properties include the zipcode id, city (id), county (id), and state (id).
\nThis reference data is used throughout other endpoints such as /programs, which accepts the 5-digit Zipcode value in the zipcode[] query parameter.
Useful for mapping the zipcode[] values in program results or for building geographic filters.
Use optional state or city parameters to filter results by a particular state or city.
Name, ID, and other properties are not expected to change.
\nGeographic datasets are static and updated periodically.
\nThe Territories endpoint returns a list of U.S. territories. These reference IDs are used throughout other endpoints, such as /programs.
Useful for mapping territory.id values in program results or for building geographic filters.
IDs are stable and not expected to change.
\nThe Geographic Data endpoints provide standardized location data for programs in the DSIRE dataset.
They help define where a program applies — from state level down to specific ZIP codes.
Use state, county, or city parameters to narrow results.
These IDs can be passed as filters in /programs queries.
Geographic datasets are static and updated periodically.
\nSummary:
\nRetrieves a list of all available utilities, or utilities filtered by state. This endpoint is part of the Reference Data set, providing utility data to help refine program searches. Use the returned utility IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
state : use ID from /states endpoint.
Usage Notes:
\nUse this endpoint to dynamically populate utility filter options in your application or UI, with the option to display utilities by state.
\nTo paginate results, use the limit and offset query parameters.
Use optional state parameter to limit results to a particular state.
The response includes utility IDs, names, states, EIA IDs, and related metadata.
\ncurl -X GET \"/utilities?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\ncurl -X GET \"/utilities?limit=10&offset=0&state=2\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nThe Utilities endpoints return a list of electric and gas utilities across the U.S.
Utilities often act as program administrators, funding sources, or implementing sectors.
Useful for mapping utility.id values in program results or for building geographic filters
Utilities may serve multiple states and can be filtered by state
Consider combining this with /implementing-sectors for administrative mapping
Summary:
\nReturns the list of available policy/incentive types for use with the Programs API.
\nThis endpoint is part of the Reference Data set, which provides filter data to help refine program searches. Use the returned type IDs as filter values when querying the Programs API to return programs by policy/incentive type.
\nAuthentication:
\nRequires an API key
\nPass your API key as x-api-key header
Parameters:
\nlimit (integer, optional): The maximum number of results to return per page.
offset (integer, optional): The number of results to skip before starting to collect the result set (for pagination).
search[value]: Filter by keyword. Example value: bonds
orderBy: Sorts results alphabetically, by NAME
orderDir: Defines the sort direction, ASC or DESC
Usage Notes:
\nUse this endpoint to dynamically populate type filter options in your application or UI.
\nTo paginate results, use the limit and offset query parameters.
\nTo filter by a keyword, use the search[value] parameter.
To sort results alphabetically, use the orderBy and orderDirection parameters.
The response includes type IDs, names, and related metadata.
\ncurl -X GET \"{{baseUrl}}/types?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nThe Types endpoint provides definitions for each policy or incentive type supported in the DSIRE dataset.
\nEach type describes the mechanism or structure of a program (e.g., rebate, loan, performance-based incentive).
\nUse type.id when filtering programs by incentive or policy type.
Use
\nReturned IDs are stable across API versions.
\nThe dataset is shared across all states and sectors.
\nSummary:
\nRetrieves a list of eligible sectors for use with the Programs API. This endpoint is part of the Reference Data set, providing eligible sector data to help refine program searches. Use the returned IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
Usage Notes:
\nUse this endpoint to populate eligible sector filter options in your application or UI.
\nTo paginate results, use the limit and offset query parameters.
The response includes sector ID, name, a list of child records, and other metadata.
\ncurl -X GET \"/sectors?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nSummary:
\nRetrieves a list of implementing sectors for use with the Programs API. This endpoint is part of the Reference Data set, providing implementing sector data to help refine program searches. Use the returned IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
Usage Notes:
\nUse this endpoint to populate implementing sector filter options on the programs endpoint.
\nCombine with the state filter on the programs endpoint to return only state-specific programs, or programs specific to other sectors within a particular state.
To paginate results, use the limit and offset query parameters.
The response includes ID, name, status, and other metadata.
\ncurl -X GET \"/implementing-sectors?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nThe Sectors endpoints provide classifications for program beneficiaries and implementing entities.
\nUse sector.id to filter by target audience.
Use implementing_sector.id to filter by administering organization.
Consider combining this with /utilities for administrative mapping.
These datasets are static and used across most program types.
\nSummary:
\nReturns the list of available categories for use with the Programs API. This endpoint is part of the Reference Data set, which provides filter data to help refine program searches. Use the returned category IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key
\nPass your API key as x-api-key header
Parameters:
\nlimit (integer, optional): The maximum number of results to return per page.
offset (integer, optional): The number of results to skip before starting to collect the result set (for pagination).
Usage Notes:
\nUse this endpoint to dynamically populate category filter options in your application or UI.
\nTo paginate results, use the limit and offset query parameters.
\nThe response includes category IDs, names, and related metadata.
\nExample Request:
\ncurl -X GET \"{{baseUrl}}/categories?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nThe Categories endpoint provides a list of general program categories used to filter programs. These are general policy and incentive categories for programs.
\nUse this endpoint to filter programs records by category.
\nEndpoint is read-only and updated infrequently.
\nSummary:
\nRetrieves a list of available technology filter options for use with the Programs API.
\nThis endpoint is part of the Reference Data set, providing technology data to help refine program searches. Use the returned technology IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
The orderBy and orderDir query parameters allow sorting of results.
Usage Notes:
\nUse this endpoint to dynamically populate technology filter options in your application or UI.
\nThe response includes technology IDs, names, and related metadata.
\nExample Request:
\ncurl -X GET \"/technologies?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nSummary:
\nRetrieves a list of available technology category filter options for use with the Programs API. This endpoint is part of the Reference Data set, providing technology category data to help refine program searches. Use the returned IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
The orderBy and orderDir query parameters allow sorting of results.
Usage Notes:
\nUse this endpoint to populate technology category filter options in your application or UI.
\nThe response includes technology category ID, name, related energy category ID and object.
\nExample Request:
\ncurl -X GET \"/technology-categories?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nSummary:
\nRetrieves a list of technology categories associated with a specific energy category. This endpoint is part of the Reference Data set, that helps refine program searches. Use an energy category ID to get a list of technology categories associated with that energy category. Use the associated energy and technology category IDs when calling the programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
The orderBy and orderDir query parameters allow sorting of results.
Usage Notes:
\nThis endpoint is useful for retrieving all technology categories under a specific energy category, such as \"Electric Vehicles\".
\nPrograms can be filtered by technology category ID (includes all technologies within that technology category)
\nExample Request:
\ncurl -X GET \"/energy-categories/:energyCategoryId/technology-categories?orderBy=name&orderDir=ASC\" \\\n -H \"x-api-key: \"\n\nSummary:
\nRetrieves a list of available energy category filter options for use with the Programs API. This endpoint is part of the Reference Data set, providing energy category data to help refine program searches. Use the returned IDs as filter values when querying the Programs API.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
The orderBy and orderDir query parameters allow sorting of results.
Usage Notes:
\nUse this endpoint to populate energy category filter options in your application or UI.
\nThe response includes energy category ID, name, and related metadata.
\nExample Request:
\ncurl -X GET \"/energy-categories?limit=10&offset=0\" \\\n -H \"x-api-key: <YOUR_API_KEY>\"\n\nRetrieves detailed information about a specific energy category by its unique ID.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Usage Notes:
\nProvide the id of the energy category as a path parameter in the request URL.
The endpoint returns the id and name of the energy category, and associated metadata.
\nUse this endpoint to look up information about a particular energy category for display, validation, or integration purposes.
\n(Required)
\n","type":"text/plain"},"type":"any","value":"3","key":"energyCategoryId"}]}},"response":[{"id":"f7b789a4-65dc-47f3-b3ae-735921ab93ca","name":"200 OK - Get energy category details","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseUrl}}/energy-categories/:energyCategoryId","host":["{{baseUrl}}"],"path":["energy-categories",":energyCategoryId"],"variable":[{"key":"energyCategoryId","value":"3","description":"(Required) "}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store, no-cache, must-revalidate, post-check=0, pre-check=0"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Fri, 26 Sep 2025 18:48:18 GMT"},{"key":"Expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"Pragma","value":"no-cache"},{"key":"Server","value":"Apache"},{"key":"Strict-Transport-Security","value":"max-age=15552000"},{"key":"Strict-Transport-Security","value":"max-age=15552000"},{"key":"Vary","value":"Accept-Encoding,User-Agent"},{"key":"X-Powered-By","value":"PHP/5.6.31"},{"key":"Content-Length","value":"141"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 3,\n \"name\": \"Electric Vehicles\"\n }\n ],\n \"meta\": {\n \"total\": 1,\n \"limit\": 10,\n \"offset\": 0,\n \"tag\": \"energy_categories\"\n },\n \"draw\": null,\n \"recordsTotal\": 1,\n \"recordsFiltered\": 1\n}"}],"_postman_id":"e935d203-19f1-410f-a062-a7c7d1f90edd"},{"name":"List technologies by technology category","id":"c170b8ad-c3f7-48d0-b7aa-1904f99f0078","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{baseUrl}}/energy-categories/technology-categories/:technologyCategoryId/technologies?limit=10&offset=0&orderBy=name&orderDir=ASC","description":"Summary:
\nRetrieves a list of all technologies for a specified technology category. It also returns the energy category ID associated with the technology category. This endpoint is part of the Reference Data set, that helps refine program searches.
\nAuthentication:
\nRequires an API key.
\nPass your API key in the x-api-key header.
Parameters:
\nlimit (integer, optional): Maximum number of results to return per page.
offset (integer, optional): Number of results to skip before starting to collect the result set (for pagination).
The orderBy and orderDir query parameters allow sorting of results.
Usage Notes:
\nThis endpoint can be used to get all technologies within a specific technology category, such as \"Charging Equipment\".
\nPrograms data can be filtered by technology category ID + one or more technologies[]
\nThe orderBy and orderDir query parameters allow sorting of results.
Example Request:
\ncurl -X GET \"/energy-categories/technology-categories/:technologyCategoryId/technologies?orderBy=name&orderDir=ASC\" \\\n -H \"x-api-key: \"\n\nThe energy and technology endpoints provide a list of taxonomies used to classify programs by energy and technology categories, and further by technologies. The technologies endpoint returns a comprehensive list of eligible technologies that appear in the DSIRE Programs dataset.These reference datasets are used to filter /programs.
Use these endpoints to filter programs records by energy and technology categories, and further by one or more technologies associated with a technology category.
\nTo filter programs by technology, use the technology ID and/or one or more technologies[].
\nTechnologies may belong to multiple categories.
\nEndpoints are read-only and updated infrequently.
\nThe Reference Data section provides lookup tables used throughout the DSIRE Programs API.
Each subfolder defines a distinct type of metadata used for filtering, labeling, or structuring program data.
Programs endpoints accept many of these reference IDs as query parameters:
\nGET {{baseUrl}}/programs?state[]=1&category[]=2&technology[]=10\n\nReference datasets are read-only and updated periodically.
\nIDs are stable across releases, ensuring filter consistency.
\nThese endpoints are ideal for building dropdowns, filter menus, or mapping layers.
\nSummary:
\nRSS subscription endpoint for the Program updates.
\nStructure:
\ntitle : All Programs Feed
\ndescription : Our RSS feeds provide a brief summary of what has changed with specific programs every time we update them. The All Programs feed allows you to keep up with every policy and incentive in DSIR
\ngenerator : Zend_Feed_Writer 2 (http://framework.zend.com)
\nlink : Main site link
\nItems:
\nProgram Title
\nProgram Description
\nPublish Date
\nLink (general program link)
\nGUID (not the actual GUID, just a general link)
\nComment count
\nSummary:
\nSpecific URL for a program RSS feed. Lists updates for the program.
\nStructure:
\ntitle : program title
\ndescription: program description
\ngenerator : the generator information
\nlink : site link
\nitem
\ntitle: Update title
\ndescription: Update description
\npubDate : publish update date
\nlink : URL to the program list
\nUse program ID
\n","type":"text/plain"},"type":"any","value":"5725","key":"id"}]}},"response":[],"_postman_id":"9b864d15-062a-4d91-b380-dd96431587dc"}],"id":"b18db5be-0770-4a45-8659-98c388bd3293","description":"RSS endpoints are available at {{domainUrl}}/rss/ and provide XML feeds for program updates. See individual requests for more details.