---
agentTools:
  projectIndex: https://docs.aurorasolar.com/llms.txt
---

# Utility Bills API

You can now upload, parse, and retrieve project utility bills through the Enterprise API. The [Run Utility Bill Upload](https://docs.aurorasolar.com/reference/runutilitybillupload) endpoint accepts a raw-binary body and dispatches an asynchronous parsing job, and the [Retrieve Utility Bill Upload Status](https://docs.aurorasolar.com/reference/retrieveutilitybilluploadstatus) endpoint returns the job's progress. Once parsing completes, the [List Utility Bills](https://docs.aurorasolar.com/reference/listutilitybills) and [Retrieve Utility Bill](https://docs.aurorasolar.com/reference/retrieveutilitybill) endpoints expose the parsed bill files on a project. Subscribe to the new `utility_bill_upload_job_completed` [webhook](https://docs.aurorasolar.com/reference/events#utility_bill_upload_job_completed) event to be notified when a parsing job finishes (whether the bill was uploaded via API or via the in-app UI). The webhook payload supports `<JOB_ID>`, `<UTILITY_BILL_ID>`, `<PROJECT_ID>`, `<STATUS>`, and `<SOURCE>` URL attributes. Together, these endpoints enable fully automated utility bill ingestion workflows.