Companies - Manglai API Documentation

Description

Companies are the main operational unit. Each company manages its buildings, vehicles, consumptions and emissions.

Endpoints

Method	Path	Description
GET	`/api/v1/companies`	List companies
GET	`/api/v1/companies/{id}/buildings`	Company buildings
GET	`/api/v1/companies/{id}/departments`	Departments
GET	`/api/v1/companies/{id}/organization-limits`	Organization limits
GET	`/api/v1/companies/{id}/year-configuration`	Year configuration

Example: List companies

curl -X GET "https://www.manglai.io/api/v1/companies?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

Common Parameters

page (optional): Page number
limit (optional): Items per page (max 1000)
query (optional): Search by name or external id
status (optional): Filter by status (accepted, pending, …)
isRootCompany (optional): Parent/root companies only (true) or non-root (false)
isTestCompany (optional): Test companies only (true) or exclude tests (false)
companyIds (optional): Filter by company IDs

To count without downloading all rows: limit=1 and read pagination.total.

Example: count active parent companies

curl -X GET "https://www.manglai.io/api/v1/companies?isRootCompany=true&status=accepted&isTestCompany=false&limit=1" \
  -H "Authorization: Bearer YOUR_TOKEN"