GET
Listado global de registros de tiempo de empleados
Scope:
team:time-tracking.readhttps://api.holded.com/api/v2/employee-timesDevuelve una lista paginada de todos los registros de tiempo de empleados de tu cuenta.
Parámetros
Parámetros de consulta
cursor
stringopcionalCursor opaco para paginación. Usa el valor devuelto en la respuesta anterior para obtener la siguiente página.
limit
integeropcional= 50Número máximo de registros a devolver por página
Petición
python
import requests
url = "https://api.holded.com/api/v2/employee-times?cursor=page:2&limit=50"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respuestas
Respuesta
json
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"employee_id": "507f1f77bcf86cd799439012",
"employee_name": "string",
"date": "2024-01-15T10:30:00Z",
"start_at": "2024-01-15T10:30:00Z",
"end_at": "2024-01-15T10:30:00Z",
"duration": 0,
"status": "string",
"approved": false,
"approved_by": "string",
"approved_at": "2024-01-15T10:30:00Z"
}
],
"has_more": false,
"cursor": "string"
}Respuestas exitosas
200Listado de registros de tiempo de empleadosapplication/jsonobject
items[]object[]required
idstringrequired
Unique identifier
employee_idstringrequired
Employee ID
employee_namestring | nullrequired
Employee display name
datestring<date-time> | nullrequired
Date of the time entry in ISO 8601
start_atstring<date-time>required
Start time in ISO 8601
end_atstring<date-time> | nullrequired
End time in ISO 8601
durationintegerrequired
Duration in seconds
statusstringrequired
Tracker status (running, done)
approvedbooleanrequired
Whether the entry is approved
approved_bystring | nullrequired
User ID who approved
approved_atstring<date-time> | nullrequired
Approval date in ISO 8601
has_morebooleanrequired
Whether there are more items on the next page
cursorstring | nulloptional
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json429Límite de solicitudes excedidoapplication/json