Tools — Invoices - Manglai API Documentation

Available Tools

Tool	Endpoint	Description
`get_invoices`	`GET /api/v1/invoices`	Invoice list with filters
`get_invoice`	`GET /api/v1/invoices/{id}`	Single invoice
`get_invoices_dashboard`	`GET /api/v1/invoices/dashboard`	Invoice summary

Invoice Types

heat — Heat/Thermal energy
fuel — Fuels
electricity — Electricity
generated-energy — Generated energy
process-emissions — Process emissions
water — Water
wastes — Waste
wastes-expenses — Waste management expenses
waste-water — Wastewater
others — Others

Usage Examples

"List electricity invoices for this year"
→ get_invoices({ companyId: "uuid", type: "electricity", startDate: "2024-01-01", endDate: "2024-12-31" })

"Give me the details of invoice X"
→ get_invoice({ id: "invoice-uuid" })

"How much did we spend on water invoices in Q1?"
→ get_invoices_dashboard({ companyId: "uuid", type: "water", startDate: "2024-01-01", endDate: "2024-03-31" })

Common Parameters

`get_invoices`

Parameter	Type	Description
`companyId`	string	Company ID (required)
`type`	string	Invoice type
`startDate`	string	Start date (ISO 8601)
`endDate`	string	End date (ISO 8601)
`buildingIds`	string[]	Filter by buildings
`page`	integer	Page number
`limit`	integer	Results per page (max 200 recommended; use pagination for larger datasets)