GET
/v1/checkins
Permesso richiesto checkins.read
Elenca le accettazioni
Le accettazioni dell'officina, dalla più recente. Filtra per stato con
status (active o completed), per testo con q e per periodo con
from / to. Negli elenchi line_items è null per alleggerire la
risposta: le righe arrivano solo sul dettaglio.
Risposte
- 200
- Una pagina di accettazioni.
- 401
- Chiave API mancante, non valida, revocata o scaduta.
- 402
- Il piano non include l'accesso API, oppure non è attivo un abbonamento.
- 403
- La chiave non ha il permesso richiesto per questa operazione.
- 415
- Il Content-Type deve essere application/json e Accept deve accettare JSON.
- 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/checkins \ -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \ -H "X-API-Version: 2026-07-20"
Risposta
{
"object": "list",
"data": [
{
"object": "checkin",
"id": "e4b7d290-6c15-4a83-9f27-1d8b3e5a7c60",
"seq_number": 142,
"status": "active",
"title": "Accettazione tagliando",
"customer_id": "4c911f08-7713-4e83-bdf6-a0692a1b43fd",
"customer_name": "Mario Rossi",
"vehicle_id": "8821f0ac-5d2b-41e7-9a10-6c3f2b7d4e55",
"vehicle_name": "Fiat Panda",
"vehicle_license": "AB123CD",
"work_category_id": "3a8e5c21-9d76-4f03-b418-2c6a9e7d5b40",
"work_category_name": "Tagliando",
"km": 61240,
"fuel_level": 45,
"worksheet_id": null,
"quote_id": null,
"created_at": "2026-07-15T07:40:00Z",
"updated_at": "2026-07-15T07:55:00Z"
}
],
"has_more": true,
"next_starting_after": "eyJvIjoyMH0",
"url": "/v1/checkins",
"date_filter": {
"object": "date_filter",
"preset": "year",
"from": "2026-01-01",
"to": "2026-12-31"
}
}