Retrieve validated hours
Returns a single validated hours record by its internal ID.
Tip
Check the Swagger page for more technical information on the endpoints.
Endpoint details
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/validated-hours/{id}
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-hours-to-validate.read
URL parameters
| Parameter | Description |
|---|---|
{id} |
The internal ID of the validated hours record. External references are not accepted. |
Response properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
changeVersion |
string | — | Read-only | Property to indicate the order of changes. |
id |
integer | — | Read-only | Unique identifier for the validated hours record. |
person.id |
integer | — | Read-only | Internal ID of the person the validated hours belong to. |
date |
string | — | Read-only | Date the validated hours are registered on (YYYY-MM-DD). |
startTimeInMinutes |
integer | — | Read-only | Start time of the validated hours (minutes since midnight). |
endTimeInMinutes |
integer | — | Read-only | End time of the validated hours (minutes since midnight). |
durationInMinutes |
integer | — | Read-only | Duration of the validated hours, in minutes. |
External references
The endpoint supports predefined and custom external references. See the external references page for details.
The following collections are supported for this endpoint:
| Collection | Predefined | Custom |
|---|---|---|
people |
@badge-number, @employee-number |
Supported |
Caution
There are some restrictions on the characters allowed in URL requests. See the fetching resources page for more information.
Error responses
| Status | Condition |
|---|---|
400 |
Invalid external reference specification |
401 |
Missing or invalid access token, or insufficient scope |
404 |
Validated hours record with the given ID does not exist |
Examples
Retrieving validated hours by internal ID
Example with internal ID 112568:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/validated-hours/112568
With external reference for people
Example with internal ID 112568 and the employee number as an external reference:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/validated-hours/112568?externalReferences=(people,@employee-number)
{
"changeVersion": "000008FE0001AE38005E",
"id": 12345,
"person": {
"id": 123,
"externalReferences": {
"@employee-number": "0042"
}
},
"date": "2025-01-15",
"startTimeInMinutes": 480,
"endTimeInMinutes": 720,
"durationInMinutes": 240
}