Clients

With clients endpoint you can:

• Get all clients without filter
• Get all clients with filter
• Get client
• Create client
• Update client
• Disable client

Client object has following params:

Param	Type	Description
ID	Integer	ID
name	Text	Client name
enabled	Boolean	Flag if client is enabled or disabled.
color	Text	Color in RGB format
notes	Text	Notes
email	Text	E-Mail
phone	Text	Phone
address	Text	Address
address2	Text	Address addition
addressZipCode	Text	Address zip code
addressCity	Text	City
addressCountry	Text	Country code ISO 2, for example DE, AT, CH
contactPerson	Text	Contact person
field1	Text	Free field
field2	Text	Free field
field3	Text	Free field

Get clients without filter

curl “https://testaccount.timetrackenterprise.com/api/v2/ext/clients/”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’

Get clients with search / filter

You can use following params for search / filter:

Param	Type	Description
name	Text	Client name will be used as substring.

In this example we search for all clients that have test in client name.

curl “https://testaccount.timetrackenterprise.com/api/v2/ext/clients?name=test”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’

Read client

Required params: id.

curl “https://testaccount.timetrackenterprise.com/api/v2/ext/clients/1”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’

Create new client

When creating client, you can use all params of client object.

Required params: name

curl -X “POST” “https://testaccount.timetrackenterprise.com/api/v2/ext/clients”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“name”: “Client Test”,
“field1”: “VAT ID: 123455678”
}’

Update client

For update you can use all params from client object except: name, enabled.

curl -X “PUT” “https://testaccount.timetrackenterprise.com/api/v2/ext/clients/6”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{
“email”: “test@timetrackapp.com”,
“field2”: “Test”
}’

Disable client

curl -X “DELETE” “https://testaccount.timetrackenterprise.com/api/v2/ext/clients/6”
-H ‘Content-Type: application/json’
-H ‘X-TimeTrack-Api-Secret: <API_SECRET_TOKEN>‘
-H ‘X-TimeTrack-Api-Key: <API_KEY>‘
-d $'{}’