Returns time bookings for users.

GET

https://api.awork.com/api/v1/users/timebookings

GET

/api/v1/users/timebookings

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

[
  {
    "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
      }
    ]
  }
]

Returns time bookings for users. Each booking includes its project, user, and tracked duration.

Required Permissions

The user must have permission to access the requested resource.

Authentication

AuthorizationBearer

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

Query parameters

userIdsstringRequired

The ids of the users.

intervalStartstringRequiredformat: "date"

The start of the interval.

intervalEndstringRequiredformat: "date"

The end of the interval.

Response

userIdstringOptionalformat: "uuid"

The user id to which the time bookings belong.

timeBookingslist of objects or nullOptional

The list of time bookings of the user.

Errors

400

Bad Request Error

401

Unauthorized Error