Danville Utilities (City of Danville, Virginia) Data Access Guide
Danville Utilities is a municipal multi-service utility (electric, water, gas) serving 42,984 electric customers across 500 square miles of south-central Virginia. Unusually for a city this size, it runs one of the more progressive municipal data programs: Green Button Connect My Data with OAuth 2.0 and SFTP delivery, a published CIS Infinity REST API with Swagger documentation, and a formal third-party registration pathway — making automated C&I data integration genuinely feasible.
How to Get Your Danville Utilities (City of Danville, Virginia) Data: All Access Methods
| Method | 1st Party | 3rd Party | Customer Types | Data Types | Latency | Format |
|---|---|---|---|---|---|---|
| Customer Billing Portal | ✓ | — | Residential and commercial (electric, water, gas) | Bills, consumption history, transactions | Monthly billing cycle | Web / PDF |
| Green Button Connect My Data | ✓ | ✓ | All customers; registered third parties with consent | 12-24 months interval usage and billing summaries | One-time transfer per authorization (~10-day provider approval) | ESPI XML (OAuth 2.0 / SFTP) |
| CIS Infinity REST API | ✓ | ✓ | Approved developers and partners | Accounts, billing, meter readings, consumption | Real-time capable | JSON (XML optional) |
| EDI | — | — | Not available | N/A | N/A | N/A |
Billing Data Access
Danville Utilities provides billing access through its customer portal — current and historical bills, multi-year consumption graphs, and transaction summaries — plus programmatic access via the CIS Infinity REST API. Third-party billing access runs through the Green Button Connect program.
What Data Is on Your Danville Utilities (City of Danville, Virginia) Bill
- Current and historical bills (PDF)
- Multi-year consumption history bar graphs
- Detailed transaction summaries
- Account details across electric, water, and gas services
How to Download Danville Utilities (City of Danville, Virginia) Bills (Business & Commercial)
- 01Register each commercial account in the portal and link them under one profile
- 02Use consumption history graphs and transaction summaries for multi-account review
- 03For high-volume or automated billing data needs, request CIS Infinity REST API credentials from utildept@danvilleva.gov or (434) 799-5125
- 04Register consultants or aggregators through the Green Button Connect program for standardized data delivery
How to Download Danville Utilities (City of Danville, Virginia) Bills (Residential)
- 01Visit https://danvilleutilities.com/app/login.jsp and click the registration link
- 02Register at https://danvilleutilities.com/app/register.jsp with your account/customer number (format 1234567890-12345678) and meter number (omit the leading E/W character)
- 03Create a username, complex password, and security question
- 04Opt into paperless billing if desired
- 05Log in to view bills, consumption history, and transaction summaries; add multiple accounts from the Profile tab
Want to understand the charges on your bill?
See the Danville Utilities (City of Danville, Virginia) Rate Schedules & Tariff Guide →Interval Data & Smart Meters
Danville deployed AMI smart meters (planning documented from 2008-2009) and delivers interval data through Green Button in ESPI/Atom XML, including interval readings, consumption summaries, service delivery point information, and billing period summaries. Customers select 12- or 24-month historical windows at request time.
How to Download Danville Utilities (City of Danville, Virginia) Interval Data via Green Button
- 01Log in to the Danville Utilities account portal
- 02Navigate to the data sharing section
- 03Request a Green Button download of energy usage data
- 04Select a 12- or 24-month historical window
- 05Download the ESPI/Atom XML file containing interval readings and billing period summaries
Interval data is essential for rate comparison and TOU analysis.
See which Danville Utilities (City of Danville, Virginia) rate schedule is best for your usage pattern →Sources
Third-Party API Access
Danville exposes two programmatic channels: (1) the CIS Infinity REST API (Advanced Utility Systems/Harris, deployed 2008) — RESTful HTTPS with mandatory 2-way SSL, HTTP Basic authentication, Swagger/OpenAPI documentation, JSON primary format, and endpoints covering accounts, billing history, meter data, and consumption; and (2) the Green Button Connect program for standardized ESPI XML delivery with customer consent. API access requires utility-issued credentials and data sharing agreements.
Available Danville Utilities (City of Danville, Virginia) API Endpoints
| Function | Endpoint | Method | Format |
|---|---|---|---|
| Resource collections (accounts, billing, meters) | /data/(bizobjname) | GET/POST/PUT/PATCH | JSON (XML optional) |
| Specific resource retrieval and updates | /data/(bizobjname)/(id) | GET/PUT/PATCH | JSON |
| Business function execution | /do/(function) | POST | JSON |
| Report generation, scheduling, and asynchronous result retrieval | /run/report and /run/pickup | POST/GET | JSON |
How to Register as a Danville Utilities (City of Danville, Virginia) API Vendor
- 01Register as a third-party provider at the Green Button portal: company info, services (electric/water/gas), customer segment, 12- or 24-month window, OAuth redirect/notify URLs or SFTP config, PEM SSL certificate, ToS and privacy policy URLs
- 02Agree to the Danville Utilities/SCM Green Button Terms & Conditions and await approval (~10 business days)
- 03For deeper integration, request CIS Infinity REST API developer credentials from utildept@danvilleva.gov with company info, business purpose, technical contacts, and an SSL certificate for mutual TLS
- 04Review the Swagger documentation at https://cis5.danvilleva.gov/ and implement pagination and retry logic
EDI (Electronic Data Interchange)
No formal EDI program found — no ANSI X12 support, enrollment procedures, transaction set lists, specifications, or VAN partnerships are published. (Virginia Natural Gas, a separate utility, offers EDI; Danville has not published equivalent capabilities.) Inquire at (434) 799-5125 or utildept@danvilleva.gov.
Sources
Rate Schedules & Tariff Analysis
Rate specifics were not enumerated in this research. The CIS Infinity platform provides a modern rate engine with unlimited rate structure configuration, and an Energy Efficiency Program Consultant RFP (2026) indicates internal consumption-analysis capability. C&I customers should contact Customer Accounts at (434) 799-5125 for applicable schedules.
For a deeper analysis including cost optimization strategies and historical rate trends:
Read the full Danville Utilities (City of Danville, Virginia) Rate Optimization Guide →Other Data Access Programs
Smart Energy Program (Demand Response)
SCM-managed residential demand response with smart thermostat enrollment, multi-channel event notifications (text, push, IVR, email), and bill credits: $75 enrollment bonus plus up to $40/year in event credits.
- 01Create or log into an SCM account at the outage portal
- 02Configure compatible smart thermostat(s)
- 03Enroll in the Smart Energy Program and grant DR event consent
- 04Receive notifications and view earned credits in the portal
Outage Portal & Notifications
Separate registration system for real-time outage notifications, status tracking, and guest notification access — customer engagement infrastructure rather than a data access channel.
- 01Register independently at the outage portal
- 02Subscribe to text, push, or email notifications
- 03Track outage status in real time
Limitations & Considerations
- ⚠Green Button data transfers once per customer consent — not a recurring automated feed; re-authorization needed for refreshes.
- ⚠Interval granularity (15-minute vs hourly) is not explicitly published.
- ⚠No EDI program documented (no ANSI X12 transaction support).
- ⚠CIS Infinity REST API access requires utility approval and 2-way SSL; no self-service developer signup.
- ⚠No documented partnerships with national aggregators (Urjanet, Arcadia, etc.), though the Green Button program is open to them.
Danville Utilities (City of Danville, Virginia) Data Access FAQ
How do C&I customers get interval data from Danville Utilities?▾
Through Green Button: log into the customer portal, request a usage download, and receive ESPI/Atom XML with interval readings and billing summaries for a selectable 12- or 24-month window. For programmatic, real-time-capable access to billing and meter data, request CIS Infinity REST API credentials from utildept@danvilleva.gov.
Does Danville support automated third-party data sharing?▾
Yes — unusually for a municipal utility this size. Third parties register through the Green Button Connect program (OAuth 2.0 redirect/notify URLs or SFTP, PEM SSL certificate, ToS/privacy policy URLs) with approval in about 10 business days. One caveat: data transfers once per customer consent rather than as a recurring feed, so refreshes require re-authorization.
What does the CIS Infinity REST API expose?▾
Accounts, billing history and transactions, meter data and readings, consumption details, and service delivery point information — via RESTful HTTPS with HTTP Basic auth and mandatory 2-way SSL. Endpoints include /data/(bizobjname), /do/(function), and /run/report for scheduled reporting, all documented in Swagger at https://cis5.danvilleva.gov/. JSON is the primary format with optional XML.
Does Danville Utilities support EDI?▾
No. There is no published ANSI X12 transaction support (814/820/867/810), enrollment process, or VAN partnership. Businesses needing structured exchange should use the CIS Infinity REST API or Green Button ESPI XML instead, or inquire directly at (434) 799-5125.
Which services does the Green Button program cover?▾
Electric, water, and gas — registrants select which services and which customer segments (commercial, residential, or both) they serve, plus a 12- or 24-month historical window. Data arrives in standardized ESPI XML via OAuth redirect with an SFTP backup option.
What does Nectar's roadmap support level mean for Danville Utilities?▾
Danville is on Nectar's roadmap with strong integration fundamentals: Green Button ESPI XML and a documented REST API mean automated ingestion is genuinely feasible. While native support is built, Nectar can work with customer-downloaded Green Button files or pursue registered third-party access through the SCM program.
The Best Way to Access Data from Danville Utilities (City of Danville, Virginia)
Nectar connects to Danville Utilities (City of Danville, Virginia) and 7,000+ utility providers — billing, interval, and rate data delivered automatically. No portals, no forms, no manual downloads.
Nectar for Energy & Sustainability Teams
Managing utility data for commercial or industrial buildings? Nectar offers a free energy data audit — we'll review your current setup and show you where automation can save your team hours every month.
Get a Free AuditNectar for Developers & Consultants
Building energy tools or advising clients on utility data? Nectar works with technology partners and consultants who need reliable data infrastructure.
Partner with Us