ClearGov API
ClearGov is a cloud budgeting, planning, and transparency platform used by more than 1,700 local governments and school districts to manage the annual finance cycle. An unofficial API lets you programmatically pull budget line items, capital requests, personnel forecasts, budget books, and transparency data—and push updates like department requests, scenario changes, and approvals back into ClearGov.
What is ClearGov?
ClearGov is a cloud-based budgeting, strategic planning, and reporting platform used by more than 1,700 local governments and school districts to streamline the annual finance cycle. Its Budget Cycle Management suite covers capital, personnel, and operational budgeting, automates the production of a digital budget book, and publishes a turn-key transparency center—pulling data directly from a jurisdiction's accounting system or ERP to generate budget frameworks, infographics, and project pages.
Core product modules include:
- Operational Budgeting (department-head requests, line-item approvals, multiple budget scenarios with audit trails)
- Capital Budgeting (CIP request intake via web forms, scenario planning, multi-year capital plans, project pages)
- Personnel Budgeting (salary management, position forecasting, what-if analysis)
- Digital Budget Book (automated, collaborative budget document built from ERP data)
- Transparency & Financial Engagement (public-facing infographics, charts, and AI-driven community engagement)
Common data entities:
- Budgets, Funds, Departments, Accounts, Line Items
- Capital Requests, CIP Projects, Scenarios, Funding Sources
- Positions, Salaries, Personnel Forecasts, Pay Grades
- Budget Requests, Approvals, Workflow Stages, Audit Trails
- Budget Books, Narratives, Charts, Transparency Reports
The ClearGov Integration Challenge
Finance teams run mission-critical budgeting workflows in ClearGov, but turning its portal- and form-driven processes into API-driven automation is non-trivial:
- Web-portal workflows: Department requests, line-item approvals, and CIP intake happen through ClearGov's web forms, not a documented public API
- Module spread: Operational, Capital, and Personnel Budgeting each carry their own object models, IDs, and approval lifecycles
- ERP-coupled data: Budget frameworks are seeded from each jurisdiction's accounting system or ERP, so structures vary by deployment
- Authentication complexity: SSO and MFA are common in government environments and complicate headless automation
- Scenario versioning: Budget scenarios and audit trails require precise version and effective-stage handling when read or written
- Document workflows: Digital Budget Books, narratives, and transparency exports need careful template and attachment handling
How Supergood Creates ClearGov APIs
Supergood reverse-engineers ClearGov's authenticated browser flows and module surfaces to deliver a resilient API layer for your jurisdiction's account—across Operational, Capital, and Personnel Budgeting, the Digital Budget Book, and Transparency.
- Handles username/password, SSO, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across budgets, capital requests, personnel forecasts, and approvals so you integrate once and rely on consistent objects
- Aligns with your jurisdiction's fund structure, account hierarchy, and ERP-seeded budget framework to ensure accurate access
Use ClearGov with AI agents: ClearGov MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, fund structure, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready ClearGov adapter tailored to your jurisdiction's configuration and budget framework.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as ClearGov evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a ClearGov account using username/password, SSO, or MFA and obtain a session token for downstream calls.
Budgeting
/budgetsList operational budgets with line items, funds, departments, and accounts, filtered by fiscal year and scenario.
Budgeting
/submit_requestSubmit a department budget request or line-item change into the configured approval workflow.
Capital
/capital_requestsRetrieve capital improvement requests and CIP projects with funding sources, status, and multi-year scenario data.
Personnel
/personnelPull positions, salaries, and personnel forecasts across departments and pay grades.
Transparency
/transparencyExport published transparency data, charts, and budget-book narratives for downstream reporting or public sites.
Use Cases
Sync budget data into the data warehouse
- Pull operational budgets, funds, departments, and line items into a central warehouse - Stream approval and scenario changes to downstream BI and reporting tools - Reconcile ClearGov budget figures against the source ERP general ledger
Automate capital improvement plan workflows
- Push capital requests and project data into ClearGov from intake systems - Pull CIP scenarios and funding sources back for prioritization models - Surface multi-year capital plans to dashboards without portal clicks
Keep personnel budgeting in sync with HR
- Sync positions, salaries, and pay grades from HR/payroll into personnel forecasts - Pull what-if salary scenarios for compensation and headcount planning - Reconcile forecasted personnel costs against actuals each budget cycle
Publish transparency data to public sites
- Export budget narratives, charts, and infographics for embedding on government portals - Feed transparency reports into citizen-engagement and open-data platforms - Trigger refreshes when budgets are adopted or amended
Technical Specifications
Authentication
Username/password, SSO, and MFA (SMS, email, TOTP) handled in a managed session
Connectivity
Authenticated browser flows across ClearGov's Operational, Capital, Personnel, and Transparency modules
Response format
Normalized JSON across budgets, capital requests, personnel forecasts, and transparency objects
Rate limits
Adaptive throttling tuned to your account to avoid ClearGov-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for budgets, requests, and approvals with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for budget request submission, approval status, and budget adoption changes
Latency
Sub-second reads on cached entities; multi-second writes when posting through approval workflows
Throughput
Horizontally scaled workers sized to multi-module budget volume across departments and funds
Reliability
Retry, backoff, and idempotency keys for budget request and scenario writes
Adaptation
Continuous monitoring of ClearGov releases and jurisdiction-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes data across Operational, Capital, and Personnel Budgeting, plus the Digital Budget Book and Transparency, so you can integrate budget, capital, and personnel entities through one consistent surface.
No. Supergood works with your existing ClearGov account and authenticated sessions. No marketplace or partner agreement is required to access your own jurisdiction's data.
Each account is profiled against its configured fund structure, account hierarchy, and ERP-seeded framework, so Supergood preserves your chart of accounts and budget structure rather than forcing a generic schema.
Yes. Beyond reads, Supergood can submit department budget requests, capital requests, and scenario changes into the configured approval workflow, with idempotency and audit-trail handling.
Yes. Supergood handles username/password, SSO, and MFA (SMS, email, TOTP) inside a managed session with automatic refresh, so headless automation keeps running.