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

curl -G https://api.awork.com/api/v1/users/projecttimebookings \
     -H "Authorization: Bearer <token>" \
     --data-urlencode userIds=123e4567-e89b-12d3-a456-426614174000,223e4567-e89b-12d3-a456-426614174001 \
     -d intervalStart=intervalStart \
     -d intervalEnd=intervalEnd

[
  {
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "timeBookings": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdOn": "2022-03-11T15:33:47.100Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000",
        "updatedOn": "2022-03-11T21:15:00.100Z",
        "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
        "userId": "123e4567-e89b-12d3-a456-426614174000",
        "projectId": "123e4567-e89b-12d3-a456-426614174000",
        "startDate": "2024-05-15",
        "endDate": "2024-05-18",
        "duration": 1,
        "description": "Blocker for a new project",
        "laneOrder": 1,
        "isAnonymized": true
      }
    ]
  }
]

Required Permissions

Any authenticated user.

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

Authentication

AuthorizationBearer

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

Query parameters

userIdsstringRequired

The ids of the users.

intervalStartdateRequired

The start of the interval.

intervalEnddateRequired

The end of the interval.

Response

userIdstringformat: "uuid"

The user id to which the time bookings belong.

timeBookingslist of objects or null

The list of time bookings of the user.

Errors

400

Bad Request Error

401

Unauthorized Error