ENDPOINTS

Banco de Horas

Consulte o saldo e o histórico detalhado do banco de horas de cada colaborador.

⚠️

Este endpoint requer plano PROFESSIONAL ou superior. Tenants no plano ESSENTIAL ou TRIAL receberão 400 PLAN_LIMIT.

GET/v1/bank-hoursbank-hours:read

Retorna o saldo total e o resumo mensal do banco de horas de um colaborador.

Query parameters

Campo	Tipo	Obrig.	Descrição
`employeeId`	string (UUID)	sim	ID do colaborador.
`month`	integer (1–12)	não	Mês de referência. Padrão: mês atual.
`year`	integer	não	Ano de referência. Padrão: ano atual.

curl "https://api.meuponto360.com/v1/bank-hours?employeeId=a1b2c3d4-...&month=4&year=2026" \
  -H "x-api-key: mp360_sk_sua_chave"

Resposta (200)

200 OK

{
  "summary": {
    "employeeId": "a1b2c3d4-...",
    "totalBalanceMinutes": 180,
    "totalBalanceFormatted": "+3h00",
    "month": 4,
    "year": 2026,
    "workedMinutes": 10380,
    "expectedMinutes": 10200
  },
  "entries": [
    {
      "id": "entry-uuid",
      "date": "2026-04-02",
      "deltaMinutes": 60,
      "reason": "OVERTIME",
      "description": "Horas extras aprovadas",
      "createdAt": "2026-04-02T18:05:00.000Z"
    }
  ]
}