Introduction

Termina API documentation: extract structured data from energy bills using AI-powered OCR. Process electricity, gas, and LPG bills from retailers in Australia, NZ, UK, USA, and Canada. Returns 30+ fields as clean JSON including NMI, usage, tariff rates, charges, and time-of-use breakdowns. Free tier: 50 API credits for unvalidated data, no credit card required.

Energy bill data extraction API

Termina’s API extracts structured data from energy bills using AI-powered OCR. Send a PDF of any electricity, gas, or LPG bill and receive clean JSON with 30+ fields — account details, NMI, usage breakdowns, tariff rates, charges, and energy provider information.

No model training. No infrastructure. One endpoint.No model training. No infrastructure. One endpoint.No model training. No infrastructure. One endpoint.

< 3 seconds

Average processing time per bill\

99%+ accuracy

Field-level OCR accuracy across all supported retailers

30+ data fields

Structured JSON covering every charge, rate, and meter reading

How it works

1. Send your bill

   POST an energy bill PDF to a single endpoint. Any retailer, any format — electricity, gas, LPG, or embedded network invoices.

   curl -X POST https://api.termina.io/v1/extract \
     -H "X-API-Key: YOUR_API_KEY" \
     -F "file=@energy_bill.pdf"
   
2. AI-powered OCR extracts and validates

   Termina’s energy-trained OCR handles all the document processing and invoice parsing — identifying fields like NMI, kWh usage, tariff rates, and cost breakdowns, then cross-checking values and flagging anomalies.

3. Get structured JSON

   Receive a clean response with account details, utility usage and consumption metrics, charges, tariff rate steps, time-of-use breakdowns, and more — ready to feed into your app, ERP, or dashboard.

What data is extracted

The API returns structured data across five categories from every energy bill:

Account & identity

Account number, NMI/MIRN, customer name, supply address

Billing details

Billing period, billing days, invoice number, due date

Utility usage & demand

Total kWh/MJ, peak/off-peak/shoulder consumption metrics, demand kW, meter readings

Cost calculation & tariff rates

Supply charges, usage charges, network fees, tariff rate steps, time-of-use breakdowns, GST, total due

Energy provider information

Retailer name, ABN, plan name, contract dates

Bill validation

Automated cross-checks, anomaly flags, and charge total verification

Supported countries and retailers

Termina supports energy bills from retailers across:

• Australia — AGL, Origin Energy, EnergyAustralia, Alinta Energy, Red Energy, Simply Energy, Powershop, Momentum Energy, and all others
• New Zealand — Mercury, Meridian, Genesis, Contact, and all others
• United Kingdom — British Gas, EDF, Octopus Energy, E.ON, and all others
• United States — Major utilities across all deregulated markets
• Canada — Major utilities across all provinces

More countries are on the roadmap. The OCR handles any bill layout from any retailer in these markets — no configuration needed.

Supported bill types

Bill type	Classification codes	Fields extracted
Electricity	Network, retail, environmental, market, demand charges	kWh usage, peak/off-peak/shoulder, demand kW, tariff rate steps, time-of-use breakdowns
Gas	Network, retail, environmental charges	MJ usage, meter reads, daily supply charges
LPG	Supply, delivery charges	Volume, unit rates, delivery fees
Embedded networks	On-supply charges, common area	kWh usage, embedded tariff rates

Use cases

Multisite cost management

Consolidate utility bills across all your locations. Automate cost calculation by site, flag rate increases, and spot billing errors.\

ESG & emissions reporting

Feed extracted utility usage data and consumption metrics directly into Scope 2 calculations. Automate NGER, NABERS, and sustainability reporting.

Build your own energy app

Embed bill extraction into energy comparison tools, solar calculators, property platforms, or any custom application.
\

Your energy data, structured in one place

Termina is more than an OCR tool. Every bill you process is stored in your Termina dashboard - searchable, filterable, and exportable as CSV, XLSX, or PDF.

Unlike general-purpose tools like AWS Textract or Google Document AI that return raw text you still need to parse and store, Termina validates and structures all of your energy data — including time-of-use tariffs, consumption metrics, and cost breakdowns — into a single source of truth that finance, procurement, and sustainability teams can all work from.

Get started

Quickstart

Extract your first energy bill in 60 seconds

API reference

Full endpoint documentation with request and response schemas

Frequently asked questions

What is the Termina energy bill data extraction API?

Termina is an AI-powered OCR API that extracts structured data from energy bills. Send an electricity, gas, or LPG bill as a PDF and receive clean JSON with 30+ fields — including account details, NMI, usage, tariff rates, time-of-use breakdowns, charges, and energy provider information. No model training or infrastructure required.

Is there a free energy bill OCR API?

Yes. Termina offers 50 free API credits with no credit card required. Each credit processes one bill. Sign up, get your API key, and start extracting structured data from energy bills in under a minute. See Quickstart to get started.

Which countries and energy retailers are supported?

Termina supports energy bills from retailers across Australia, New Zealand, the UK, the USA, and Canada. The OCR handles any bill layout from any retailer in these markets — no configuration needed. More countries are on the roadmap.

How accurate is the energy bill OCR?

Termina achieves over 99% field-level accuracy across all supported retailers. The API includes built-in bill validation that cross-checks extracted values, flags anomalies, and verifies that charge totals match line items.

How is Termina different from AWS Textract for energy bills?

Textract is a general-purpose document AI that returns raw OCR text — you still need to build parsing, validation, and storage. Termina is purpose-built for energy bills: one POST, structured JSON back with energy-specific fields like NMI, tariff rates, and time-of-use breakdowns. No S3 buckets, no IAM roles, no post-processing. Termina also serves as a system of record for your energy data, not just an extraction tool.

How is Termina different from Google Document AI?

Google Document AI offers a general invoice processor with no dedicated energy bill schema. Termina extracts energy-specific fields (NMI, MIRN, tariff structures, time-of-use splits, retailer details) out of the box — no GCP setup, no model training, no custom post-processing. Your energy data is structured in one place so finance, procurement, and sustainability teams can all use it.

Do I need to train an OCR model for my energy bills?

No. Termina comes with a pre-built extraction schema that works with every supported retailer out of the box. Unlike general-purpose OCR platforms, there is no training step, no sample uploads, and no configuration. Send a bill, get structured data back.

Can I use this API to build my own energy app?

Yes — that is exactly what it is designed for. Embed Termina’s bill extraction into energy comparison tools, solar calculators, property management platforms, ESG dashboards, or any custom application. The free tier gives you 50 credits to prototype with. See Build an energy app.

Does Termina store my bill data?

Every bill you process is available in your Termina dashboard — searchable, filterable, and exportable as CSV, XLSX, or PDF. Termina acts as a system of record for your energy data so you can leverage it across cost management, contract negotiation, and ESG reporting.