---
title: "Get capacity information"
method: GET
path: "/services/appointments/v1/capacity"
tags: ["Capacity"]
---

# Get capacity information

`GET /services/appointments/v1/capacity`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/services/appointments/v1/capacity`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/services/appointments/v1/capacity/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve capacity information for a specific site and date

## Query parameters

- `siteCode` string, required
- `capacityDate` string, date, required

## Response `200`

Capacity information retrieved successfully

- CapacityResponse
  - `availableSlots` AvailableSlot[]: List of available slots with section information
    - `endDateTime` string, date-time: End date and time for the available slot (with timezone)
    - `section` string: Section/dock door identifier
    - `startDateTime` string, date-time: Start date and time for the available slot (with timezone)
  - `bookedSlots` BookedSlot[]: List of booked slots with shipment information
    - `endDateTime` string, date-time: End date and time for the booked slot (with timezone)
    - `shipmentNumber` string: Shipment number that has booked this slot
    - `startDateTime` string, date-time: Start date and time for the booked slot (with timezone)
  - `capacityDate` string, date: Date for the capacity information
  - `siteCode` string: Code identifying the site
  - `totalSlots` integer: Total number of slots available for the date
  - `totalBookedSlots` integer: Total number of booked slots for the date
  - `totalCapacity` integer: Total available capacity (totalSlots - bookedSlots - unplannedShipments)
  - `unplannedShipmentsCount` integer: Number of unplanned shipments for the date

## Other responses

- `400`: Bad request - Invalid input data
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Site not found or no capacity data available

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)