Skip to content

index.mdx

Latest commit

 

History

History
170 lines (127 loc) · 9.18 KB

index.mdx

File metadata and controls

170 lines (127 loc) · 9.18 KB
title Introduction
description 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.

Average processing time per bill\\ Field-level OCR accuracy across all supported retailers Structured JSON covering every charge, rate, and meter reading

How it works

POST an energy bill PDF to a single endpoint. Any retailer, any format — electricity, gas, LPG, or embedded network invoices. 
```bash
curl -X POST https://api.termina.io/v1/extract \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@energy_bill.pdf"
```
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. 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 number, NMI/MIRN, customer name, supply address Billing period, billing days, invoice number, due date Total kWh/MJ, peak/off-peak/shoulder consumption metrics, demand kW, meter readings Supply charges, usage charges, network fees, tariff rate steps, time-of-use breakdowns, GST, total due Retailer name, ABN, plan name, contract dates 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

Consolidate utility bills across all your locations. Automate cost calculation by site, flag rate increases, and spot billing errors.\\ Feed extracted utility usage data and consumption metrics directly into Scope 2 calculations. Automate NGER, NABERS, and sustainability reporting. 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

Extract your first energy bill in 60 seconds Full endpoint documentation with request and response schemas

Frequently asked questions

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. 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](/quickstart) to get started. 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. 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. 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. 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. 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. 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 of unvalidated billing data (unvalidated) to prototype with. 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.