GET
/v1/time-entries
Permesso richiesto worksheets.read
Elenca i tempi registrati
I tempi registrati col Marcatempo su tutte le schede lavoro, dal più
recente per ora di inizio: timer accesi e fermati e tempi inseriti a
mano, di tutti i collaboratori. Serve per portare le ore lavorate in
un foglio presenze, in un gestionale paghe o in un'analisi della resa.
from e to sono giorni (AAAA-MM-GG, ora di Roma), entrambi
inclusi, e filtrano sull'ora di inizio; to prima di from risponde
422 con param: /to. worksheet_id limita a una scheda, user_id
a un collaboratore. I tempi delle schede eliminate non compaiono.
Un timer acceso ha running: true, ended_at: null e la durata
contata fino al momento della risposta. I tempi di attesa
(user: null, tipo con is_wait: true) non sono ore lavorate.
Serve il modulo Marcatempo attivo (403 altrimenti).
dalla revisione 2026-10-25
Nuovo endpoint: i tempi registrati col Marcatempo in un periodo, con filtri per scheda e collaboratore.
Risposte
- 200
- Una pagina di tempi, dal più recente.
- 401
- Chiave API mancante, non valida, revocata o scaduta.
- 402
- Il piano non include l'accesso API, oppure non è attivo un abbonamento.
- 403
- Il modulo Marcatempo non è attivo (Impostazioni → Moduli), oppure la chiave non ha il permesso `worksheets.read`.
- 422
- Un campo della richiesta manca o non è valido: «param» indica quale.
- 500
- Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/time-entries \ -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \ -H "X-API-Version: 2026-10-31"
Risposta
{
"object": "list",
"data": [
{
"object": "time_entry",
"id": "4e9a0c17-3b5d-4a82-9f6e-2c1b7d8e5a93",
"worksheet_id": "a5d21e64-8f37-4b90-ae12-3c7d6b048f95",
"time_type_id": "7f4c1b98-2d6e-4a35-9c81-0e5b3a7d2f14",
"user": null,
"started_at": "2026-10-23T08:30:00Z",
"ended_at": "2026-10-23T09:30:00Z",
"duration_seconds": 3600,
"running": false,
"note": "Pastiglie in arrivo dal fornitore",
"source": "manual",
"forgotten": false,
"suggested_stop_at": null,
"can_edit": true,
"can_stop": false,
"can_discard": false
},
{
"object": "time_entry",
"id": "1f6b3d82-7a9c-4e05-b1d4-6e8a2c9f0b37",
"worksheet_id": "a5d21e64-8f37-4b90-ae12-3c7d6b048f95",
"time_type_id": "3b8e2f71-6c4a-4d19-9e05-7a1c2d3e4f60",
"user": {
"object": "time_person",
"id": "2f3e4d5c-6b7a-4980-8f1e-2d3c4b5a6978",
"first_name": "Marco",
"last_name": "Esposito"
},
"started_at": "2026-10-23T07:00:00Z",
"ended_at": "2026-10-23T08:30:00Z",
"duration_seconds": 5400,
"running": false,
"note": "Smontaggio freni anteriori",
"source": "timer",
"forgotten": false,
"suggested_stop_at": null,
"can_edit": true,
"can_stop": false,
"can_discard": false
}
],
"has_more": true,
"next_starting_after": "eyJ0IjoiMjAyNi0xMC0yM1QwNzowMDowMFoiLCJpIjoiMWY2YjNkODItN2E5Yy00ZTA1LWIxZDQtNmU4YTJjOWYwYjM3In0",
"url": "/v1/time-entries"
}