← API documentation

Timers API

Content
GET /timers

Retrieve running timers

Returns your running timers, newest first.

Request
curl "https://financial.gyvex.com/api/timers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
POST /timer/start

Start timer

Starts a timer right now, optionally for a project and/or customer.

Parameter Description
project_id, customer_id ID of one of your projects or customers, optional.
Request
curl -X POST "https://financial.gyvex.com/api/timer/start" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 4}'
POST /timer/{id}/stop

Stop timer

Stops the timer and converts it into a billable time entry. Without hours the elapsed time is used. The timer is removed and the new time entry is in the response (status 201).

Parameter Description
hours Number of hours, optional.
description Description, optional.
billable Billable, true by default.
Request
curl -X POST "https://financial.gyvex.com/api/timer/9/stop" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"description": "Ontwerp homepage"}'
DELETE /timer/{id}

Delete timer

Deletes the timer without registering hours. On success you receive status 204.

Request
curl -X DELETE "https://financial.gyvex.com/api/timer/9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"

Need help with your integration?

Create a ticket via "My Gyvex" in your dashboard. With Premium you get priority support, with a reply within 24 hours.