Saltar al contenido principal
GET

Listado global de registros de tiempo de empleados

Scope:team:time-tracking.read
https://api.holded.com/api/v2/employee-times

Devuelve una lista paginada de todos los registros de tiempo de empleados de tu cuenta.

Parámetros

Parámetros de consulta

cursorstringopcional

Cursor opaco para paginación. Usa el valor devuelto en la respuesta anterior para obtener la siguiente página.

limitintegeropcional= 50

Nú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/json
object
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/json
403Permisos insuficientesapplication/json
429Límite de solicitudes excedidoapplication/json