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

# Buildings

> Manage buildings and properties

## Description

**Buildings** represent physical properties or locations associated with a company. Consumptions (electricity, heating, etc.) are linked to buildings.

## Endpoints

| Method | Path                                               | Description                       |
| ------ | -------------------------------------------------- | --------------------------------- |
| GET    | `/api/v1/companies/{id}/buildings`                 | List company buildings            |
| GET    | `/api/v1/companies/{id}/buildings/regos`           | Building REGOs                    |
| GET    | `/api/v1/companies/{id}/buildings/regos-dashboard` | REGOs dashboard                   |
| POST   | `/api/v1/buildings/move`                           | Move buildings to another company |

## Example: List buildings

```bash theme={null}
curl -X GET "https://www.manglai.io/api/v1/companies/{companyId}/buildings?companyId={companyId}" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Usage in consumptions

When creating a consumption, you must provide the corresponding `buildingId`. Retrieve IDs using the buildings endpoint.