---
title: "Returns the time bookings in a specified time range for a list of users."
method: GET
path: "/users/timebookings"
tags: ["timeBookings"]
---

# Returns the time bookings in a specified time range for a list of users.

`GET /users/timebookings`

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

## Query parameters

- `userIds` string, required
- `intervalStart` string, date, required
- `intervalEnd` string, date, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- GetTimeBookingForUsersResult[]
  - `userId` string, uuid — The user id to which the time bookings belong.
  - `timeBookings` TimeBooking[], nullable — The list of time bookings of the user.
    - `id` string, uuid — The id of the entity.
    - `createdOn` string, date-time — The date this entity was created.
    - `createdBy` string, uuid — The id of the user who created this entity.
    - `updatedOn` string, date-time — The date this entity was last modified.
    - `updatedBy` string, uuid — The id of the user who last modified this entity.
    - `userId` string, uuid — The id of the user this time booking is for.
    - `projectId` string, uuid, nullable — (optional) The id of the project this time booking is for.
    - `startDate` string, date — The start date of the time booking.
    - `endDate` string, date — The end date of the time booking.
    - `duration` integer — The planned duration, expressed in seconds, of this time booking.
    - `description` string, nullable — The optional description for this time booking.
    - `laneOrder` integer — The order in which this object should be shown in the timeline (row number). Used by the awork web app.
    - `isAnonymized` boolean, nullable — This will be true if the user doesn't have access to the project. In that case the description will be shadowed.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)