# Luminetric Bill Data API

> Utility bills in, structured JSON statements out. Clients upload a bill PDF (or register a utility-portal login and we retrieve the bills), and receive one signed JSON webhook per statement. Contract version 1.0.0.

To write integration code, read https://luminetric.com/llms-full.txt: an implementation checklist, the full documentation and every JSON Schema in one file.

## Getting started

- [Overview](https://luminetric.com/docs/index.md)
- [Sending a bill](https://luminetric.com/docs/sending-bills.md)

## Retrieval

- [Connecting a portal](https://luminetric.com/docs/connecting-portals.md)
- [Accounts](https://luminetric.com/docs/accounts.md)

## Receiving results

- [Webhooks and signatures](https://luminetric.com/docs/webhooks.md)
- [Events](https://luminetric.com/docs/events.md)

## Statements

- [The statement payload](https://luminetric.com/docs/statement-payload.md)
- [Identity and versions](https://luminetric.com/docs/statement-identity.md)
- [Summary bills and multi-bill files](https://luminetric.com/docs/summary-bills.md)

## Reference

- [Compatibility and versioning](https://luminetric.com/docs/versioning.md)
- [Samples and schemas](https://luminetric.com/docs/samples.md)
- [Changelog](https://luminetric.com/docs/changelog.md)

## Schemas

- [request.duplicate.schema.json](https://luminetric.com/docs/schemas/request.duplicate.schema.json): JSON Schema for the `request.duplicate` webhook body
- [request.failed.schema.json](https://luminetric.com/docs/schemas/request.failed.schema.json): JSON Schema for the `request.failed` webhook body
- [retrieval.completed.schema.json](https://luminetric.com/docs/schemas/retrieval.completed.schema.json): JSON Schema for the `retrieval.completed` webhook body
- [retrieval.failed.schema.json](https://luminetric.com/docs/schemas/retrieval.failed.schema.json): JSON Schema for the `retrieval.failed` webhook body
- [statement.available.schema.json](https://luminetric.com/docs/schemas/statement.available.schema.json): JSON Schema for the `statement.available` webhook body
- [statement.withdrawn.schema.json](https://luminetric.com/docs/schemas/statement.withdrawn.schema.json): JSON Schema for the `statement.withdrawn` webhook body

## Optional

- [All sample payloads (zip)](https://luminetric.com/docs/samples/luminetric-samples-1.0.0.zip)