GET api/v1/delivery_estimates

Return estimated delivery dates for a cart, one per shipping service level: 1-Day, 2-Day, Expedited and Standard. Estimates are based on the shipping cut-off time on your DCL agreement, read in your account's own time zone (taken from the state on the account). Where more than one cut-off is on file for the account, the earliest is used; cut-offs that have not been set are ignored. A cart before the cut-off on a business day is treated as shipping that day. A cart at or after the cut-off, or on a weekend or holiday, is treated as shipping the next business day. Transit time is then added in business days — 1-Day adds 1, 2-Day adds 2, Expedited adds 3, Standard adds 7 — again skipping weekends and holidays. These are estimates, not delivery commitments. They are also calculated separately from the ship-by date applied when an order is submitted, so the two can differ for the same cart. That is expected.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
cart_time

Anchor point for the estimated date calculation. Date/time in ISO-8601 format (example: '2026-06-29T17:30:00Z'). When omitted, the current server time (UTC) is used.

 string

None.
ship_from

Optional fulfillment-origin location code, echoed back in the response when supplied. It does not affect the estimate: the cut-off comes from your agreement and is read in your account's own time zone, whichever location the order ships from.

 string

None.
account_num

Optional account the cart belongs to, used to resolve that account's shipping cut-off exactly. Must be an account available to the credential. When omitted, every account the credential covers is considered and the earliest cut-off is applied.

 string

None.

Body Parameters

None.

Response Information

Resource Description

response_get_delivery_estimates
NameDescriptionTypeAdditional information
error_code

Zero if no errors. See 'error_message' for a detailed description of the error.

 integer

None.
error_message

Returns a detailed description of the error.

 string

None.
delivery_estimates

The estimated delivery dates, the cut-off applied, and the zone it was read in. Omitted when no estimate could be produced — see 'error_code' and 'error_message'.

 delivery_estimates

None.

Response Formats

application/json, text/json

Sample: 
{
  "error_code": 0,
  "error_message": "",
  "delivery_estimates": {
    "cart_time": "2026-06-29T17:30:00Z",
    "ship_cutoff_local": "12:00",
    "ship_cutoff_time_zone": "UTC-04:00",
    "ship_from": "LN",
    "estimates": [
      {
        "service_level": "1-Day",
        "transit_business_days": 1,
        "estimated_ship_date": "2026-06-30",
        "estimated_delivery_date": "2026-07-01",
        "after_cutoff": true
      },
      {
        "service_level": "2-Day",
        "transit_business_days": 2,
        "estimated_ship_date": "2026-06-30",
        "estimated_delivery_date": "2026-07-02",
        "after_cutoff": true
      },
      {
        "service_level": "Expedited",
        "transit_business_days": 3,
        "estimated_ship_date": "2026-06-30",
        "estimated_delivery_date": "2026-07-06",
        "after_cutoff": true
      },
      {
        "service_level": "Standard",
        "transit_business_days": 7,
        "estimated_ship_date": "2026-06-30",
        "estimated_delivery_date": "2026-07-10",
        "after_cutoff": true
      }
    ]
  }
}