API service draft · Victoria first

Always-current rebate payout API

RebateSignal is being designed as an API service for installers, CRMs, quote tools, and marketplaces that need up-to-date rebate payouts and rule-driven eligibility across VEU / VEEC, STC, and Solar Victoria.

Instead of every business copying old calculator assumptions into spreadsheets, the API returns versioned scheme logic, live payout inputs, blockers, warnings, evidence requirements, and line-item estimates that can be embedded directly into quote flows.

POST /v1/quotesGET /v1/payouts/latestrule versioningsample logic only

Primary outputPayout range

Rule postureSource-versioned

First activityHot water

StatusDraft API

What the API service provides

Built for systems that need current rebate intelligence, not a one-off public calculator.

Latest payout feedExpose current VEEC/STC payout assumptions by provider, observed timestamp, price type, and confidence so quote tools stop using stale certificate values.

Eligibility + rule logicReturn activity-specific rules from VEU calculator resources, STC calculator resources, approved product data, postcode/date inputs, and decommissioning requirements.

Evidence checklistTell installers exactly what is missing before payout confidence is increased: photos, serial plates, decommissioning evidence, customer assignment, and product proof.

Example API payloads

Draft contract for how a CRM, website quote widget, or field app would call the service.

Request: quote an upgrade

POST /v1/quotes

{ "state": "VIC", "activity_type": "heat_pump_hot_water", "activity_date": "2026-07-01", "postcode": "3066", "site_type": "residential", "existing_equipment": { "fuel": "gas", "type": "storage_hot_water", "capacity_litres": 170, "decommissioned": true, "decommissioning_evidence_available": true }, "new_product": { "brand": "Example", "model": "HPHW-270", "approved_product_id": "VEU-PRODUCT-ID" }, "market_prices": { "strategy": "latest_verified", "preferred_provider": "installer_trader" } }

Response: line-item payout

200 OK

{ "eligible": true, "confidence": "indicative", "estimated_total_low": 2357.30, "estimated_total_high": 2691.40, "estimates": [ { "scheme": "VEU", "certificate_type": "VEEC", "estimated_units": 28, "unit_price": 72.50, "payout_low": 1725.50, "payout_high": 1989.40, "evidence_required": [ "customer assignment", "before/after photos", "decommissioning evidence" ], "source_versions": ["veu-rules:2026-07-01"] }, { "scheme": "STC", "certificate_type": "STC", "estimated_units": 18, "unit_price": 39.00, "payout_low": 631.80, "payout_high": 702.00, "source_versions": ["cer-stc:2026-07-01"] } ] }

Latest payouts endpoint

Installers can refresh quote assumptions automatically before sending a proposal.

GET /v1/payouts/latest?state=VIC&schemes=VEEC,STC { "observed_at": "2026-07-01T10:15:00+10:00", "prices": [ { "scheme": "VEU", "unit": "VEEC", "price": 72.50, "provider": "example-trader", "confidence": "verified" }, { "scheme": "SRES", "unit": "STC", "price": 39.00, "provider": "example-trader", "confidence": "verified" } ], "stale_after_minutes": 60 }

Accuracy safeguards

Problem in current workflows	API safeguard
Old VEEC/STC prices in spreadsheets	Timestamped payout feed with stale-price warnings.
One generic rebate number	Separate VEU, STC, and Solar Victoria line items.
Promised payout before evidence is complete	Blockers/warnings for decommissioning and product proof.
Rules change without the sales team noticing	Effective-date rule versions and source-version metadata.