Skip to main content
Extract structured data from an energy bill in three steps. You’ll have clean JSON with the NMI, charges, tariff rates and 30+ other fields in seconds.
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.
Keep your API key private. Don’t commit it to version control or expose it in client-side code.

2. Send your first bill

POST an energy bill to the upload endpoint as multipart/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.
The endpoint detects the energy type (electricity, gas or LPG), the retailer and the bill layout automatically. The file is the only input.

3. Get structured JSON back

The response has three parts: a bill_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
Not a developer? You can also upload bills directly through the dashboard: the same extraction engine, just drag, drop and export.

Frequently asked questions

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.
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.
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.
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.
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.
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.
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.
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.
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.