← API documentatie

Uren API

Inhoud
GET /time-entries

Uren ophalen

Geeft een gepagineerde lijst van urenregistraties, nieuwste eerst. Het antwoord bevat ook total_hours en billable_hours over alle resultaten die aan de filters voldoen.

Parameter Beschrijving
from_date, to_date Uren tussen twee datums.
project_id, customer_id Filter op project of klant.
billable, invoiced Filter op factureerbaar of al gefactureerd (true of false).
page, page_size Paginering, standaard 15 per pagina.
Verzoek
curl "https://financial.gyvex.com/api/time-entries?from_date=2026-11-01&billable=true" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
GET /time-entries/{id}

Urenregistratie ophalen

Geeft een urenregistratie terug, inclusief project en klant.

Verzoek
curl "https://financial.gyvex.com/api/time-entries/15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
POST /time-entry/store

Uren registreren

Registreert uren, los of bij een project en/of klant. Bij succes volgt status 201.

Veld Verplicht Beschrijving
date Ja Datum van de uren.
hours Ja Aantal uren, 0 tot 24.
start_time, end_time Nee Begin- en eindtijd (UU:MM). De eindtijd moet na de begintijd liggen.
description Nee Omschrijving.
billable Nee Factureerbaar (true of false).
project_id, customer_id Nee ID van een van uw projecten of klanten.
Verzoek
curl -X POST "https://financial.gyvex.com/api/time-entry/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"date": "2026-11-18", "hours": 3.5, "project_id": 4, "billable": true}'
PUT /time-entry/{id}/update

Urenregistratie bijwerken

Werkt een urenregistratie bij. Alleen de meegestuurde velden worden gewijzigd.

Verzoek
curl -X PUT "https://financial.gyvex.com/api/time-entry/15/update" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"hours": 4}'
DELETE /time-entry/{id}

Urenregistratie verwijderen

Verwijdert een urenregistratie. Bij succes volgt status 204.

Verzoek
curl -X DELETE "https://financial.gyvex.com/api/time-entry/15" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"

Hulp nodig bij uw koppeling?

Maak een ticket aan via "Mijn Gyvex" in uw dashboard. Met Premium krijgt u priority support, met reactie binnen 24 uur.