Get timesheet approval status for a period (obsolete variant)
Obsolete alias of get-status-by-period; returns exactly the same response.
Despite its name it does not add rejected registrations by itself: send $expand=RejectedRegistrations, as on get-status-by-period. New integrations should call get-status-by-period.
Not for:
- New integrations — use
GET /v1/approval/timesheets/get-status-by-period.
Behaviour:
- Idempotent.
- Safe to retry.
- Changes are visible to the next read immediately.
Call first: GET /v1/user
See also: GET /v1/approval/timesheets/get-status-by-period
Not yet documented: examples (success).
curl -X GET "https://app3.timelog.com/your-account/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items?employeeUserId=123&startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$expand=RejectedRegistrations&$page=25&$pagesize=25" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://app3.timelog.com/your-account/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items?employeeUserId=123&startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$expand=RejectedRegistrations&$page=25&$pagesize=25"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://app3.timelog.com/your-account/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items?employeeUserId=123&startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$expand=RejectedRegistrations&$page=25&$pagesize=25", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://app3.timelog.com/your-account/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items?employeeUserId=123&startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$expand=RejectedRegistrations&$page=25&$pagesize=25", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://app3.timelog.com/your-account/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items?employeeUserId=123&startDate=2024-12-25T10%3A00%3A00Z&endDate=2024-12-25T10%3A00%3A00Z&$expand=RejectedRegistrations&$page=25&$pagesize=25')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"Properties": {
"WeekDays": [
{
"ApprovalStatus": "Empty",
"Hours": 3.14,
"Date": "2024-12-25T10:00:00Z",
"LastRejectedComment": "null",
"RecentRejectedComment": {
"ManagerName": "null",
"ManagerComment": "example_string"
},
"RejectedRegistrations": [
{
"CustomerID": "null",
"CustomerName": "John Doe",
"CustomerNo": "example_string",
"ProjectID": "null",
"ProjectName": "John Doe",
"ProjectNo": "example_string",
"TaskID": "null",
"TaskName": "John Doe",
"TaskFullName": "John Doe",
"IsFixedPrice": "null",
"TaskNo": "example_string",
"TaskIsActive": "null",
"AbsenceCodeID": "null",
"AbsenceName": "John Doe",
"AbsenceCode": "example_string",
"AbsenceIsActive": "null",
"AdditionalTextIsRequired": true,
"DefaultBillable": true,
"IsETCProject": true,
"ShowBillable": true,
"AllocatedHour": "null",
"TimeRegistrationID": 123,
"EntityID": 123,
"EntityType": 42,
"UserID": 123,
"Created": "2024-12-25T10:00:00Z",
"CreatedBy": 42,
"LastModified": "2024-12-25T10:00:00Z",
"LastModifiedBy": 42,
"IsBillable": true,
"Status": true,
"Date": "2024-12-25T10:00:00Z",
"MonthlyPeriod": "example_string",
"Comment": "example_string",
"Hours": 3.14,
"AdditionalTextField": "example_string",
"InvoiceStatus": true,
"TimeRegistrationApprovalStatus": 42,
"TimeTrackingFormat": 42,
"Minutes": 42,
"BillableHours": 3.14,
"BillableMinutes": 42,
"IsFavourite": true,
"StartTime": "null",
"EndTime": "null",
"IsTimestampOverlapping": true
}
],
"HasResubmittedRejectedRegistration": true
}
],
"PeriodStatus": "Empty",
"LastRejectedComment": "null",
"RecentRejectedComment": {
"ManagerName": "null",
"ManagerComment": "example_string"
}
},
"Links": [
{
"Href": "example_string",
"Rel": "example_string"
}
],
"Actions": [
{}
]
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"Message": "No HTTP resource was found that matches the request URI 'https://app{server-number}.timelog.com/{account}/api/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items'.",
"MessageDetail": "No action was found on the controller 'ApprovalTimesheet' that matches the request."
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/v1/approval/timesheets/get-status-by-period-with-rejected-time-tracking-items
Target server for requests. Edit to use your own host.
OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.
Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.User ID of the employee. Omitted -> 404 action-not-matched.
Refers to UserRead.UserID. Look up valid values with GET /v1/user.
First day, inclusive.
Last day, inclusive.
Expansion of the per-day rejected registrations.
Allowed values:
| Value | Name | Meaning |
|---|---|---|
| RejectedRegistrations | RejectedRegistrations | Fill RejectedRegistrations on each Rejected day. Without it the list is empty, whatever the route name says. |
Applied to each Rejected day's RejectedRegistrations list.
Page size of each Rejected day's RejectedRegistrations list.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
Not yet documented: how to obtain a token.
Not yet documented: token lifetime.
Query Parameters
User ID of the employee. Omitted -> 404 action-not-matched.
Refers to UserRead.UserID. Look up valid values with GET /v1/user.
First day, inclusive.
Last day, inclusive.
Expansion of the per-day rejected registrations.
Allowed values:
| Value | Name | Meaning |
|---|---|---|
RejectedRegistrations | RejectedRegistrations | Fill RejectedRegistrations on each Rejected day. Without it the list is empty, whatever the route name says. |
RejectedRegistrationsApplied to each Rejected day's RejectedRegistrations list.
Page size of each Rejected day's RejectedRegistrations list.
Responses
The approval state of a run of consecutive days of one employee's timesheet (a period or an ISO week): every day's status in WeekDays plus one aggregated PeriodStatus. No ID: identified by (employee, first day, last day).