List Utility Bills

Lists every utility bill uploaded to the project, newest first, with a fresh presigned file_url for each. The download URLs expire after 24 hours; re-call this endpoint (or Retrieve Utility Bill) to refresh them.


Last-parse-wins semantics. Only the most recently parsed bill feeds the project's load profile and consumption data. Older bills returned by this endpoint are historical artifacts — they remain in storage but are not currently being used by Aurora to compute consumption. This matches the in-app utility bill upload UI, which only ever displays the most recent upload.

Because parse jobs run asynchronously and are not strictly FIFO, sort order (created_at descending) reflects upload time, not parse-completion time. Upload bills one at a time — wait for each utility_bill_upload_job_completed webhook before starting the next upload — to keep the active bill predictable.

Path Params
uuid
required

The ID of the tenant that the project is part of.

uuid
required

The ID of the project to list utility bills for.

Responses

Language
Credentials
Bearer
header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json