---
title: "Get External Booking"
method: GET
path: "/api/v2/resource_management/ext-systems/resourcing/ext-bookings/{extBookingId}"
tags: ["Ext Booking"]
---

# Get External Booking

`GET /api/v2/resource_management/ext-systems/resourcing/ext-bookings/{extBookingId}`

## Request

- Base URL: `https://apiv2.eightfold.ai`
- URL: `https://apiv2.eightfold.ai/api/v2/resource_management/ext-systems/resourcing/ext-bookings/{extBookingId}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/eightfold/apis/api-server-v2-service-service/docs/api/v2/resource_management/ext-systems/resourcing/ext-bookings/:extBookingId/get.ts> (a function with typed inputs; its response is checked against the schema)

Given an external booking id, it returns all attributes of the external booking

## Path parameters

- `extBookingId` string, required

## Query parameters

- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- ExtBookingSchema
  - `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']

---

[API](https://skmtc.dev/eightfold/apis/api-server-v2-service-service.md) - [All operations](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/llms.txt) - [OpenAPI document](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/revisions/9a8b3a927e93?raw)