Urjanet provides a utility data aggregation API that collects usage data from utility providers; access requires a commercial agreement — contact Urjanet to obtain API credentials.
Authenticate to the Urjanet REST API using the credentials provided; the API uses OAuth or API key authentication as documented in the partner materials.
Create an account connection by submitting the tenant's utility account credentials (username and password for the utility portal) via the Urjanet account provisioning endpoint; Urjanet fetches data on your behalf.
Poll the account status endpoint or use webhooks to detect when usage data has been successfully pulled for a utility account; data availability depends on utility provider sync frequency.
Retrieve billing and usage records via the statements or usage endpoint; each record contains billing period, total kWh or CCF consumed, charges, and meter ID.
Map meter IDs to property unit IDs in your system and calculate per-unit utility charges for submetered billing; post the resulting charges to your property management platform's tenant ledger.
Known gotchas
Urjanet is a data aggregation service, not a direct utility API; data availability, latency, and coverage vary significantly by utility provider — not all utilities are supported, and some have multi-day sync delays.
Collecting tenant utility credentials on their behalf raises significant privacy and security obligations; ensure your data handling practices and disclosures comply with applicable laws, including CPRA and state-level utility regulations.
Utility bills for submetered units may reflect the master meter reading plus a markup; ensure your billing logic correctly allocates shared costs and complies with submetering regulations in the relevant jurisdiction.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp