Conta colaboradores agrupados por status

curl --request GET \
  --url https://api.example.com/colaborador/status-count

{
  "total": 10,
  "active": 7,
  "inactive": 2,
  "draft": 1
}

Colaborador

Conta colaboradores agrupados por status

Retorna agregação rápida do quadro de funcionários por status, sem precisar paginar a lista completa. Ideal para dashboards e KPIs de RH.

O que retorna: objeto com totais por status — ATIVO, INATIVO, AFASTADO, DEMITIDO — além do total geral. Os totais respeitam os mesmos filtros aceitos por GET /colaborador (departamento, cargo, equipe, etc.).

Casos de uso:

Card “Colaboradores ativos” no dashboard interno
Alerta “X afastados há mais de 30 dias” (combinar com filtro de período)
Snapshot mensal para auditoria

Performance: muito mais leve que GET /colaborador em UNs grandes (10k+ colaboradores) — use sempre que precisar só dos totais.

GET

colaborador

status-count

Conta colaboradores agrupados por status

curl --request GET \
  --url https://api.example.com/colaborador/status-count

{
  "total": 10,
  "active": 7,
  "inactive": 2,
  "draft": 1
}

Query Parameters

collaboratorTypes

string

Filtro por tipos de cadastro de colaborador, separados por vírgula

Example:

"PRESTADOR_SERVICO,CLT,EXTERNO,API"

Response

Totais agregados por status (objeto plano com counts)

total

number

required

Total de colaboradores

Example:

10

active

number

required

Número de colaboradores ativos

Example:

7

inactive

number

required

Número de colaboradores inativos

Example:

2

draft

number

required

Número de colaboradores em rascunho

Example:

1

Lista colaboradores da unidade de negócio Exporta todos os colaboradores como CSV