Companies (Empresas) - Manglai API Documentation

Descripción

Las empresas son la unidad operativa principal. Cada empresa gestiona sus edificios, vehículos, consumos y emisiones.

Endpoints

Método	Ruta	Descripción
GET	`/api/v1/companies`	Listar empresas
GET	`/api/v1/companies/{id}/buildings`	Edificios de una empresa
GET	`/api/v1/companies/{id}/departments`	Departamentos
GET	`/api/v1/companies/{id}/organization-limits`	Límites organizacionales
GET	`/api/v1/companies/{id}/year-configuration`	Configuración de años

Ejemplo: Listar empresas

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

Parámetros comunes

page (opcional): Número de página
limit (opcional): Elementos por página (máx. 1000)
query (opcional): Buscar por nombre o external id
status (opcional): Filtrar por estado (accepted, pending, …)
isRootCompany (opcional): Solo empresas madre (true) o no-madre (false)
isTestCompany (opcional): Solo tests (true) o excluir tests (false)
companyIds (opcional): Filtrar por IDs

Para contar sin descargar todas las filas: limit=1 y lee pagination.total.

Ejemplo: contar empresas madre activas

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

companyIds (opcional): Filtrar por IDs de empresa