Listar Registros de Ponto

Lista registros de ponto com filtros. Paginação com page/limit. Requer scope registros:read.

Autenticação:

🔑 API Key

Parâmetros de Consulta

empresa_idnumber

Filtrar por empresa

colaborador_idnumber

Filtrar por colaborador

data_iniciostring

Data inicial (YYYY-MM-DD)

data_fimstring

Data final (YYYY-MM-DD)

pagenumber

Página (padrão: 1)

limitnumber

Itens por página (padrão: 100, máximo: 1000)

Respostas

{
  "ok": true,
  "data": {
    "registros": [
      {
        "numeracao": 1,
        "colaborador_id": 10,
        "nome_colaborador": "João Silva",
        "data_marcacao": "2026-02-04T08:00:00Z",
        "tipo_registro": 1,
        "checkin_checkout": "Entrada"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 150,
      "totalPages": 2
    }
  }
}

Sandbox Mode

curl --request GET \
  'http://localhost:3000/api/v1/registros-ponto?empresa_id=1&colaborador_id=10&data_inicio=2026-02-01&data_fim=2026-02-28&page=1&limit=100' \
  --header 'x-api-key: yk_sua_api_key'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "registros": [
      {
        "numeracao": 1,
        "colaborador_id": 10,
        "nome_colaborador": "João Silva",
        "data_marcacao": "2026-02-04T08:00:00Z",
        "tipo_registro": 1,
        "checkin_checkout": "Entrada"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 100,
      "total": 150,
      "totalPages": 2
    }
  }
}