---
title: "Get Delivery Times"
method: POST
path: "/deliverytime"
tags: ["LookupApi"]
---

# Get Delivery Times

`POST /deliverytime`

Gets available delivery and pickup times, assisting in scheduling and planning shipments.

## Request body

- ClientAPIGetDeliveryTimeRequestDto
  - `pickupDate` string, date-time, nullable — Requested pickup date. If null, the nearest available pickup date is used.
  - `pickupCountryCode` string, nullable — ISO country code of the pickup address.
  - `pickupZipCode` string, nullable — Postal/zip code of the pickup address.
  - `pickupCity` string, nullable — City of the pickup address.
  - `deliveryCountryCode` string, nullable — ISO country code of the delivery address.
  - `deliveryZipCode` string, nullable — Postal/zip code of the delivery address.
  - `deliveryCity` string, nullable — City of the delivery address.
  - `overseasPrintsLabels` boolean, nullable — Set to true when the shipment is an overseas shipment that prints its own labels. Affects which delivery time rules are applied.

## Response `200`

OK

- ClientAPIGetDeliveryTimeResponseDto
  - `status` 'OK' | 'Error' | 'ValidationFailed' — 0 = OK, 1 = Error, 2 = ValidationFailed
  - `validations` ClientAPIValidation[], nullable
    - `code` integer
    - `message` string, nullable
    - `params` object, nullable
  - `error` ClientAPIError
    - `code` integer
    - `message` string, nullable
    - `stackTrace` string, nullable
    - `innerException` ClientAPIError — recursive
    - `validations` ClientAPIValidation[], nullable
      - `code` integer
      - `message` string, nullable
      - `params` object, nullable
    - `messageParams` string[], nullable
    - `payload` JToken[]
  - `traceID` string, nullable
  - `data` DeliveryTimes
    - `sendDate` string, date-time, nullable — Date the shipment is expected to be sent (dispatched) once picked up, based on the pickup route's availability.
    - `pickupDate` string, date-time, nullable — First available pickup date for the requested pickup address, based on the pickup route's availability. Equals the requested PickupDate when that date is available.
    - `pickupZipCode` string, nullable — Resolved postal/zip code of the pickup address, as recognized by the routing lookup.
    - `pickupCity` string, nullable — Resolved city of the pickup address, as recognized by the routing lookup.
    - `deliveryZipCode` string, nullable — Resolved postal/zip code of the delivery address, as recognized by the routing lookup.
    - `deliveryCity` string, nullable — Resolved city of the delivery address, as recognized by the routing lookup.
    - `pickupIntervals` TimeIntervalDate[], nullable — Available pickup time windows for PickupDate.
      - `from` string, nullable — Start of the pickup/delivery interval (ISO 8601 datetime string).
      - `until` string, nullable — End of the pickup/delivery interval (ISO 8601 datetime string).
    - `deliveryIntervals` TimeIntervalDate[], nullable — Available delivery time windows for the calculated delivery date.
      - `from` string, nullable — Start of the pickup/delivery interval (ISO 8601 datetime string).
      - `until` string, nullable — End of the pickup/delivery interval (ISO 8601 datetime string).
    - `pickupPlaceValid` boolean — Indicates whether the requested pickup address could be resolved to a valid, serviceable route.
    - `deliveryPlaceValid` boolean — Indicates whether the requested delivery address could be resolved to a valid, serviceable route.
    - `isPickupPlaceExact` boolean — True if the resolved pickup city and zip code exactly match the ones requested; false if the system fell back to the nearest serviceable match.
    - `isDeliveryPlaceExact` boolean — True if the resolved delivery city and zip code exactly match the ones requested; false if the system fell back to the nearest serviceable match.
    - `pickupServiceFlags` integer — Bitmask of coverage services (see CoverageServicesFlags) available for the pickup side of the route.
    - `deliveryServiceFlags` integer — Bitmask of coverage services (see CoverageServicesFlags) available for the delivery side of the route.

---

[API](https://skmtc.dev/expressone/apis/client-api.md) · [All operations](https://skmtc.dev/expressone/apis/client-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expressone/client-api/revisions/2acf7e4a5080/schema)