---
search:
  tags:
    - timebookings
    - GET
seo:
  description: >-
    Retrieves a paginated, filterable grid of all time booking entries in…
    Reference for the GET /timebookings/timeGrid endpoint in the Leadtime Public
    API API.
sidebar:
  badge: GET
  label: Get time bookings grid
title: Get time bookings grid
type: openapi-operation
---
Retrieves a paginated, filterable grid of all time booking entries in the workspace.

**What are Time Bookings?**
Time bookings (also called time logs or time entries) are records of working hours that employees have logged to specific tasks or projects. They document how much time was spent on different activities, which is essential for:
- Project planning and resource allocation
- Billing customers accurately
- Analyzing productivity and team workload
- Understanding where time is being spent in the organization

**What data is returned:**
The grid returns time booking entries with the following information:
- **Date**: When the time was logged
- **Hours**: Amount of time logged (decimal format, e.g., 8.5 for 8 hours 30 minutes)
- **Comment**: Optional notes about the work performed
- **Project ID**: The project the time was logged to
- **Task ID**: The specific task (if time was logged to a task rather than just a project)
- **User ID**: Which employee logged the time
- **Activity ID**: The type of work performed (e.g., development, research, management)
- **Value Group**: The project value group for categorization

**Response includes:**
- Paginated list of time booking items
- Total count of matching entries
- **totalHours**: Sum of all hours across filtered entries (useful for reporting)
- Current page and page size

**Filtering and sorting:**
You can filter by date range, project, task, user, activity, or value group. Quick search is available on comments. Results are sorted by date (newest first) by default.

**Permissions:**
Requires either "seeLoggedTimeDetails" (to see your own time) or "seeCompanyLoggedTime" (to see all company time).

<Operation source="api-reference" id="timebookingscontroller-gettimegrid" />
