iopoint
Referência

Horas extras / Banco

Saldo de horas extras e banco em uma data específica.

URL Base
https://api.iopoint.com.br/api

Endpoints

Saldo do dia

GET/customer/v2/overtime

Retorna o regime do colaborador (BH, HE, Híbrido) e os componentes do dia: total de horas extras, horas faltantes, intervalo, normais, saldo do dia, saldo acumulado e crédito/débito acumulados separados.

Valores HH:MM:SS. Regime pode ser BH, HE, Híbrido (BH) ou Híbrido (HE).
credit e debt representam, respectivamente, o total bruto creditado (bank_time_factored) e debitado (negative_bank_time) desde o início da faixa de banco de horas vigente até a data consultada. accumulated_balance é o saldo líquido completo, incluindo saldo inicial e pagamentos de banco.

Query parameters

NomeTipoObrig.Descrição
datedatesimData de referência (YYYY-MM-DD).
national_registrystringnãoCPF do colaborador para filtrar. Opcional.
include_branchesbooleannãoQuando `1`, agrega a matriz e todas as filiais do grupo econômico na resposta. Só leitura.
company_national_registrystringnãoCNPJ (apenas dígitos) de uma empresa do grupo para restringir o escopo a ela. Use os CNPJs retornados em `GET /economic-group`. Fora do grupo acessível retorna `company_not_found` (404).

Exemplos

Request
curl -X GET "https://api.iopoint.com.br/api/customer/v2/overtime?date=2026-05-26" \
  -H "apiIopointToken: SEU_TOKEN_AQUI"
Response200
{
  "data": [
    {
      "national_registry": "12345678900",
      "registration_number": "0042",
      "email": "[email protected]",
      "name": "João da Silva",
      "occupation": "Analista de RH",
      "department": "Recursos Humanos",
      "team": null,
      "business_unit": "Matriz",
      "admission_date": "2022-03-15",
      "pis": "12345678901",
      "company": {
        "name": "Filial São Paulo LTDA",
        "trading_name": "Filial SP",
        "national_registry": "12345678000288"
      },
      "regime": "BH",
      "total_overtime": "01:30:00",
      "missing_hours": "00:00:00",
      "interval_hours": "01:00:00",
      "normal_hours": "08:00:00",
      "day_balance": "01:30:00",
      "accumulated_balance": "12:15:00",
      "credit": "18:45:00",
      "debt": "06:30:00"
    }
  ],
  "meta": {
    "date": "2026-05-26"
  }
}

Respostas

200
{
  "data": [
    {
      "national_registry": "12345678900",
      "registration_number": "0042",
      "email": "[email protected]",
      "name": "João da Silva",
      "occupation": "Analista de RH",
      "department": "Recursos Humanos",
      "team": null,
      "business_unit": "Matriz",
      "admission_date": "2022-03-15",
      "pis": "12345678901",
      "company": {
        "name": "Filial São Paulo LTDA",
        "trading_name": "Filial SP",
        "national_registry": "12345678000288"
      },
      "regime": "BH",
      "total_overtime": "01:30:00",
      "missing_hours": "00:00:00",
      "interval_hours": "01:00:00",
      "normal_hours": "08:00:00",
      "day_balance": "01:30:00",
      "accumulated_balance": "12:15:00",
      "credit": "18:45:00",
      "debt": "06:30:00"
    }
  ],
  "meta": {
    "date": "2026-05-26"
  }
}