Referência

Atrasos

Listar atrasos detectados no período.

URL Base

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

Endpoints

GET/customer/v2/tardinessAtrasos no período

Atrasos no período

GET/customer/v2/tardiness

Lista os atrasos detectados por colaborador. O algoritmo considera atraso quando a batida de entrada ocorre após o início da jornada somado à tolerância configurada, e antes de 2 horas após o início (acima disso é tratado como falta).

Query parameters

Nome	Tipo	Obrig.	Descrição
begin_date	date	sim	Início do período (YYYY-MM-DD).
end_date	date	sim	Fim do período (YYYY-MM-DD). Máximo de 31 dias.
national_registry	string	não	CPF do colaborador para filtrar. Opcional.
include_branches	boolean	não	Quando `1`, agrega a matriz e todas as filiais do grupo econômico na resposta. Só leitura.
company_national_registry	string	não	CNPJ (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).

Erros possíveis

Status	Código	Quando ocorre
422	date_range_exceeded	Período maior que 31 dias.

Exemplos

Request

curl -X GET "https://api.iopoint.com.br/api/customer/v2/tardiness?begin_date=2026-05-01&end_date=2026-05-31" \
  -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"
      },
      "tardiness": [
        {
          "date": "2026-05-12",
          "journey_in": "08:00",
          "punch_in": "08:17",
          "minutes_late": "00:17",
          "all_points": [
            "08:17",
            "12:00",
            "13:00",
            "17:00"
          ]
        }
      ]
    }
  ],
  "meta": {
    "begin_date": "2026-05-01",
    "end_date": "2026-05-31"
  }
}

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"
      },
      "tardiness": [
        {
          "date": "2026-05-12",
          "journey_in": "08:00",
          "punch_in": "08:17",
          "minutes_late": "00:17",
          "all_points": [
            "08:17",
            "12:00",
            "13:00",
            "17:00"
          ]
        }
      ]
    }
  ],
  "meta": {
    "begin_date": "2026-05-01",
    "end_date": "2026-05-31"
  }
}

Request

curl -X GET "https://api.iopoint.com.br/api/customer/v2/tardiness?begin_date=2026-05-01&end_date=2026-05-31" \
  -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"
      },
      "tardiness": [
        {
          "date": "2026-05-12",
          "journey_in": "08:00",
          "punch_in": "08:17",
          "minutes_late": "00:17",
          "all_points": [
            "08:17",
            "12:00",
            "13:00",
            "17:00"
          ]
        }
      ]
    }
  ],
  "meta": {
    "begin_date": "2026-05-01",
    "end_date": "2026-05-31"
  }
}