---
title: "Get available slots for shipment"
method: POST
path: "/services/appointments/v1/slots"
tags: ["Slots"]
---

# Get available slots for shipment

`POST /services/appointments/v1/slots`

## Request

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

Retrieve available time slots for a shipment

## Request body

- SlotRequestSchema
  - `appointmentWindow` object
    - `start_date_time` string, date-time: Start date and time for slot search (ISO 8601 format with timezone)
    - `end_date_time` string, date-time: End date and time for slot search (ISO 8601 format with timezone)
  - `identifiers` object
    - `shipmentReference` string: Reference number for the shipment
    - `siteCode` string: Code identifying the site
    - `stopSequenceNumber` integer: Stop sequence number for multi-stop shipments

## Response `200`

Available slots retrieved successfully

- SlotsResponse
  - `results` SlotResult[]
    - `shipmentReference` string: Reference number for the shipment
    - `siteCode` string: Code identifying the site
    - `stopReferenceNumber` integer: Stop reference number for multi-stop shipments
    - `slots` SlotTime[]
      - `endDateTime` string, date-time: End date and time for the available slot (with timezone)
      - `startDateTime` string, date-time: Start date and time for the available slot (with timezone)
  - `status` string: Status of the operation

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: No slots 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)