Skip to main content

​
Invoice Tools

Tools for querying energy invoices (electricity, gas, water, diesel, etc.) with co2e emissions. Each invoice is linked to a facility.

​
list_invoices

Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the organization
invoice_typestringNoFilter: electricity, natural_gas, diesel, water, heat, etc.
statusstringNoFilter: active, deleted
facility_idstringNoFilter by facility UUID
start_datestringNoFrom date (YYYY-MM-DD)
end_datestringNoTo date (YYYY-MM-DD)
pageintegerNoPage number (default: 1)
sizeintegerNoResults per page (default: 50, max: 100)
Example queries: 
"List our electricity invoices"
"Show gas invoices from last quarter"
"Which invoices have the highest CO2 emissions?"
Example response: 
{
  "items": [
    {
      "id": "b46d1f0a-...",
      "type": "electricity",
      "status": "active",
      "quantity": 3060.8,
      "co2e": 1347.0,
      "start_date": "2025-06-30T00:00:00",
      "end_date": "2025-07-31T00:00:00",
      "facility_id": "4cc2ac22-...",
      "cups": "ES0022000006089269MY1P"
    }
  ],
  "total": 625,
  "page": 1,
  "size": 50
}

​
Invoice Types

  • electricity — Electricity consumption
  • natural_gas — Natural gas
  • diesel — Diesel fuel
  • water — Water consumption
  • heat — District heating