> ## Documentation Index
> Fetch the complete documentation index at: https://developers.manglai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools — Invoices

> Query supply invoices with the Manglai MCP

## 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      |