List bills
octopus_list_billsList an Octopus Energy account's bills newest first, including billing period, issue date, charges, credits, and opening/closing balances; optionally include temporary PDF download links.
Instructions
List the account's bills (statements), newest first: the period covered, issue date, charges and credits, and the opening and closing balances, all in pounds. Set include_pdf_links for a temporary link to each bill's PDF.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "octopus_list_bills"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only bills issued on or before this date (YYYY-MM-DD) | |
| from | No | Only bills issued on or after this date (YYYY-MM-DD) | |
| limit | No | How many to return, newest first (default 6, at most 50) | |
| account_number | No | Account number like A-1234ABCD (default OCTOPUS_ACCOUNT, or the only account the API key can see) | |
| include_pdf_links | No | Include a temporary download link for each bill's PDF (the link expires after a short time) |