# Estimate delivery dates

This operation provides delivery date estimation for Wineshipping fulfillment using FedEx and UPS carrier services within the USA. It requires an authenticated request with the recipient delivery address and desired range of future ship dates to generate a set of results for each applicable carrier and service class combination available for the delivery address and specified dates.

Note: The information provided by the Wineshipping Delivery Date Estimate API service is for estimating approximate delivery dates based on the corresponding FedEx and/or UPS carrier service information available at the time of inquiry, and is subject to change without notice. Due to these factors, Wineshipping cannot guarantee the accuracy of current or future information generated by the Delivery Date Estimate API service.

Endpoint: POST /api/Tracking/GetDeliveryEstimates
Version: 3.1.3

## Request fields (application/json):

  - `Authentication` (object, required)
    Credentials are required for all API operations.

  - `Authentication.UserKey` (string, required)
    Example: C445598CB576468EA35FBB22C55584EF

  - `Authentication.Password` (string, required)
    Example: AF63FDAC1E704DC1AC9460F669ABF107

  - `Authentication.CustomerNo` (string, required)
    Example: 10703

  - `ClientReferenceCode` (string)
    Example: abcd-1234

  - `DeliveryAddress` (object, required)

  - `DeliveryAddress.StreetLines` (array)

  - `DeliveryAddress.City` (string)
    Example: Napa

  - `DeliveryAddress.State` (string)
    Example: CA

  - `DeliveryAddress.ZipCode` (string)
    Example: 94558

  - `DeliveryAddress.Country` (string)
    Example: US

  - `DeliveryEstimateRange` (integer, required)
    Controls how many future ship dates to generate for delivery estimates. If DeliveryEstimateRange = 5, it will return up to 5 valid shipping dates. Each date includes both the ship date and its associated cutoff time. Weekends and holidays are skipped when determining valid ship dates.
    Example: 1

## Request examples:

  - `Basic` (unknown)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `TransactionReferenceNumber` (string)

  - `DeliveryAddress` (object)

  - `DeliveryAddress.StreetLines` (array)

  - `DeliveryAddress.City` (string)
    Example: Napa

  - `DeliveryAddress.State` (string)
    Example: CA

  - `DeliveryAddress.ZipCode` (string)
    Example: 94558

  - `DeliveryAddress.Country` (string)
    Example: US

  - `DeliveryEstimateOptions` (array)

  - `DeliveryEstimateOptions.DeliveryDateEstimate` (string)

  - `DeliveryEstimateOptions.ShipmentDate` (string)

  - `DeliveryEstimateOptions.CutoffTime` (string)

  - `DeliveryEstimateOptions.ShippingWarehouse` (string)

  - `DeliveryEstimateOptions.ShippingOptions` (array)

## Response 400:

  - `400` (unknown)
    Invalid Input Data

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 429:

  - `429` (unknown)
    Too Many Requests [... see rate-limit details](https://wineshipping-api.redocly.app/../../../../docs/infrastructure#rate-limits--quotas)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 200 examples:

  - `Basic` (unknown)