v1
latestOpenAPI 3.0.02026-07-241010520.6 KBList 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 parameters
The ID of the tenant that the project is part of.
The ID of the project to list utility bills for.
Response
Utility bills retrieved.
Example response
{
"utility_bills": [
{
"name": "march_bill",
"extension": ".pdf",
"mime_type": "application/pdf",
"size": 102400,
"created_at": "2017-07-21T17:32:28Z"
}
]
}