Returns the time bookings in a specified time range for a list of users. | awork API

1 import requests 2 3 url = "https://api.awork.com/api/v1/users/timebookings" 4 5 querystring = {"userIds":"123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001","intervalStart":"2024-5-13","intervalEnd":"2024-5-21"} 6 7 headers = {"Authorization": "Bearer <token>"} 8 9 response = requests.get(url, headers=headers, params=querystring) 10 11 print(response.json())

1 [ 2 { 3 "userId": "123e4567-e89b-12d3-a456-426614174000", 4 "timeBookings": [ 5 { 6 "id": "123e4567-e89b-12d3-a456-426614174000", 7 "createdOn": "2024-01-15T09:30:00Z", 8 "createdBy": "123e4567-e89b-12d3-a456-426614174000", 9 "updatedOn": "2024-01-15T09:30:00Z", 10 "updatedBy": "123e4567-e89b-12d3-a456-426614174000", 11 "userId": "123e4567-e89b-12d3-a456-426614174000", 12 "projectId": "123e4567-e89b-12d3-a456-426614174000", 13 "startDate": "2024-05-15", 14 "endDate": "2024-05-18", 15 "duration": 1, 16 "description": "Blocker for a new project", 17 "laneOrder": 1, 18 "isAnonymized": true 19 } 20 ] 21 } 22 ]

Required Permissions

Any authenticated user.

<Check title="Required Permissions">Any authenticated user.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query Parameters

userIdsstringOptional

The ids of the users to get the time bookings for, as a comma-separated list of Guids.

intervalStartstringRequiredformat: "date"

The start of the interval to filter by.

intervalEndstringRequiredformat: "date"

The end of the interval to filter by.

Response

userIdstring or nullformat: "uuid"

The user id to which the time bookings belong.

timeBookingslist of objects or null

The list of time bookings of the user.