---
title: "List Bookings"
method: GET
path: "/api/v2/resource_management/bookings"
tags: ["Booking"]
---

# List Bookings

`GET /api/v2/resource_management/bookings`

Search bookings using query parameters and get the complete booking objects. Atleast one of employeeEmail or demandId is required in filters.

## Query parameters

- `start` integer
- `limit` integer
- `employeeEmail` string
- `demandId` string
- `startDate` string
- `endDate` string
- `bookingType` string
- `bookingStatus` string
- `include` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` BookingSchema[]
    - `createdAt` integer, nullable — Created timestamp for the booking
    - `updatedBy` string, nullable — User who updated the booking
    - `isArchived` boolean, nullable — A flag indicating if booking is archived
    - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
    - `extData` ExtBooking
      - `creatorEmail` string, required — Email of the creator of the booking
      - `createdAt` integer, required — Creation timestamp for the booking
      - `bookingId` integer, nullable — Internal booking ID
      - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
      - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
      - `bookedCapacity` ExtBookingCapacityData
        - `unit` 'hours' | 'percentage' | 'fraction', required — Unit of capacity. Possible values: ['hours', 'percentage', 'fraction']
        - `timeGranularity` 'daily' | 'weekly' | 'monthly', nullable — Time granularity of capacity. Possible values: ['daily', 'weekly', 'monthly']
        - `capacity` number, float, required — Capacity value
      - `lastModifiedAt` integer, nullable — Last modified timestamp for the booking
      - `endDate` integer — [DEPRECATED] End date of the booking in epoch timestamp format. Use endDateIso instead.
      - `lastModifierEmail` string, nullable — Email of the last modifier of the booking
      - `extBookingId` string, required — External booking id
      - `startDate` integer — [DEPRECATED] Start date of the booking in epoch timestamp format. Use startDateIso instead.
      - `extDemandId` string, nullable — External demand id for the demand associated with the booking
      - `employeeId` string, required — Employee id
      - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
      - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
    - `capacity` number, float, required — Booked capacity of employee
    - `startDate` integer — [DEPRECATED] Start date of the booking. Use startDateIso instead.
    - `archivedAt` integer, nullable — Archived timestamp for the booking
    - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
    - `bookingId` integer, nullable — Booking id
    - `demandId` integer, nullable — Demand id associated with the booking
    - `endDate` integer — [DEPRECATED] End date of the booking. Use endDateIso instead.
    - `updatedAt` integer, nullable — Updated timestamp for the booking
    - `employeeProfileId` integer, nullable — Profile ID of the employee
    - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
    - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
    - `createdBy` string, nullable — User who created the booking
    - `employeeEmail` string, required — Email of employee
  - `meta` MetaSchema
    - `totalCount` integer, nullable
    - `pageTotalCount` integer, nullable
    - `pageStartIndex` integer, nullable

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)