This GET method allows you to retrieve a list of registrations (time trackings) between a given from and till date.
Notes:
- Maximum 35 days will be returned per request. Every day can contain multiple registrations.
- You can use the limit and offset parameters to retreive custom datasets
- The returned registrations will be sorted by date (descending)
- Request
- Response
Parameters
DateFrom
Date String (dd-MM-yyyy)
Details
From date in format dd-MM-yyyy. Defaults to no from date.
DateTill
Date String (dd-MM-yyyy)
Details
To date in format dd-MM-yyyy. Defaults to no to date.
Limit
Integer
Details
Define an optional limit for the retrieve. Defaults to 35 which is also the maximum.
Offset
Integer
Details
Define an optional offset for the retrieve.
AccountEmail
String
Details
An optional filter on user e-mail to filter out registrations for certain users.
CURL Example
1 |
curl -X GET -H "Content-Type: application/json" -H "ApiKey: b7d343Bnhd436f3ec3bd3504582" -H "Username: [email protected]" "https://rest-api.silvasoft.nl/rest/listdayregistrations/?DateFrom=25-11-2018&limit=5" |
Parameters
Date
String
More info
The dayregistration date in format dd-MM-yyyy.
Status
String
More info
The dayregistration status. Can be either To_much, To_little or Complete.
TotalHours
Float
More info
The total amount of hours registered for this day
OvertimeHours
Float
More info
The amount of overtime hours for this day
AbsenceHours
Float
More info
The amount of hours absent for this day
WorkedHours
Float
More info
The amount of hours worked on this day
AccountEmail
String
More info
The email of the employee to whom the registrations apply
AccountName
String
More info
The name of the employee to whom the registrations apply
DayRegistration_Registration
Array
More info
An array of registrations for this day
Registration > Description
String
More info
The description that the user entered for this day
Registration > Hours
String
More info
Registration > Invoiced
Boolean (true|false)
More info
Whether or not this registration has been invoiced to a client. The manager can mark registrations as invoiced.
Registration > Billable
Boolean (true|false)
More info
Whether or not the hours on this registrations are billable.
Registration > StartingHour
String
More info
If full registration is used (with from and to time) this will show the starting hour (24h format)
Registration > EndingHour
String
More info
If full registration is used (with from and to time) this will show the ending hour (24h format)
Registration > StartingMinute
String
More info
If full registration is used (with from and to time) this will show the starting minute
Registration > EndingMinute
String
More info
If full registration is used (with from and to time) this will show the ending minute
Registration > BreaksIncluded
Boolean (true|false)
More info
Whether breaks are included in the registration
Registration > ProjectName
String
More info
If the registration is associated with a project, this will show the project name
Registration > ProjectPhase
String
More info
If the registration is associated with a project phase, this will show the project phase
Response JSON Example
The response order can vary from the parameter order above
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
[ { "Status": "To_much", "AbsenceHours": 0, "WorkedHours": 10, "DayRegistration_Registration": [ { "BreaksIncluded": true, "EndingMinute": "00", "EndingHour": "17", "Description": "Done research on IOT", "StartingHour": "09", "Hours": 10, "Billable": false, "Invoiced": false, "StartingMinute": "00" }], "OvertimeHours": 2, "TotalHours": 10, "Date": "13-12-2018", "AccountName": "Example Employee", }, { "Status": "Complete", "AbsenceHours": 0, "WorkedHours": 8, "DayRegistration_Registration": [ { "BreaksIncluded": true, "EndingMinute": "00", "EndingHour": "17", "Description": "Working for customer X", "StartingHour": "09", "Hours": 8, "Billable": true, "Invoiced": false, "StartingMinute": "00" }], "OvertimeHours": 0, "TotalHours": 8, "Date": "12-12-2018", "AccountName": "Example Employee", } ] |