Saltar al contingut principal
GET

Llistat global de registres de temps d'empleats

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

Retorna una llista paginada de tots els registres de temps d'empleats del teu compte.

Paràmetres

Paràmetres de consulta

cursorstringopcional

Cursor opac per a la paginació. Utilitza el valor retornat a la resposta anterior per obtenir la pàgina següent.

limitintegeropcional= 50

Nombre màxim de registres a retornar per pàgina

Petició

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())

Respostes

Resposta

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"
}

Respostes exitoses

200Llistat de registres de temps d'empleatsapplication/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.

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
429Límit de sol·licituds exceditapplication/json