Looking for business electricity rates? The business electricity rates API needs no API key: one request returns the cheapest rates for any Australian postcode, network or NMI.
Free tier: 50 API credits, no credit card required. Each credit processes one bill page.
1. Get your API key
Sign up at app.termina.io to generate your free API key instantly. No credit card, no approval process.2. Send your first bill
POST an energy bill to the upload endpoint asmultipart/form-data, with your key in the X-API-Key header. The API accepts electricity, gas and LPG bills from retailers across Australia, NZ, the UK, the USA and Canada.
3. Get structured JSON back
The response has three parts: abill_uuid, the extracted energy_data, and any validation_issues. Here’s a trimmed example from an electricity bill:
Example response
Response structure at a glance
4. Compare the site’s rates
The bill gives you the two inputs the business electricity rates API needs: the site’s NMI and its usage. Annualise the usage, then ask for the cheapest rates for that exact site:Python
summary.cheapest is the cheapest rate for that site, with its % difference from the Default Market Offer. Compare it with what the bill is costing the business today. See Using Termina with AI agents for the full flow.
What to do next
Upload API reference
Every request parameter, response field and error code.
Business electricity rates API
Find the cheapest rates for any site. No API key needed.
Using Termina with AI agents
Extract a bill, compare rates, and hand a business over to switch.
Your Termina dashboard
Every bill you process, searchable and exportable.
Accessing your data in the dashboard
Every bill you process through the API is also available in your Termina dashboard. You can:- Search and filter across all processed bills by site, retailer, date or amount
- Export to CSV, XLSX or PDF for reporting, reconciliation or sharing with your team
- Track usage trends and cost anomalies over time across all your sites
- Invite team members with role-based permissions, so finance, procurement and sustainability teams can all access the data
Frequently asked questions
What file formats does the API accept?
What file formats does the API accept?
Send the bill as
multipart/form-data under the file field. Both digital PDFs from retailer portals and scanned or photographed paper bills are supported.How long does extraction take?
How long does extraction take?
Most bills are processed in under 3 seconds. Complex multi-page bills or low-quality scans may take slightly longer. The API responds synchronously, with no polling or webhooks required.
Which energy types can the API extract?
Which energy types can the API extract?
Electricity, gas and LPG bills. The extraction covers network charges, retail charges, environmental levies, market charges and demand charges, with tariff rate steps and time-of-use breakdowns where they’re on the bill.
Can the API extract time-of-use tariff data?
Can the API extract time-of-use tariff data?
Yes. Where time-of-use pricing is on the bill, Termina extracts peak, off-peak and shoulder rates and consumption separately, including each charge’s rate steps and the kWh consumed in each period.
What happens if a bill can't be fully parsed?
What happens if a bill can't be fully parsed?
energy_data is null and validation_issues describes what went wrong. Partial extractions return the data that was read, with warnings on uncertain fields, so you always know what you can trust.How does bill validation work?
How does bill validation work?
Every extraction cross-checks the extracted charges against the bill total, verifies the billing period dates, flags unusually high or low usage, and checks tariff rates fall within expected ranges for the retailer and region. Issues are returned in
validation_issues.How do I authenticate API requests?
How do I authenticate API requests?
Include your API key in the
X-API-Key request header. You can generate a free key instantly at app.termina.io, with no credit card required.What are the rate limits?
What are the rate limits?
Free tier accounts can process up to 50 bills in total. Pro accounts have configurable rate limits based on your plan. The API returns a
429 status code with a Retry-After header if you exceed your limit.Can I find cheaper electricity rates for the bill's site?
Can I find cheaper electricity rates for the bill's site?
Yes. Pass the bill’s
site_identifier (the NMI) and annual usage to the business electricity rates API to get the cheapest rates for that site, compared with the Default Market Offer. See step 4 above.