Estimate Delivery Date | ShipBob Developer API

curl -X POST https://sandbox-api.shipbob.com/2026-01/order:estimateDeliveryDate \
     -H "x_correlation_id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "destination_address": {
    "country": "US",
    "zip_code": "60601",
    "address1": "123 Main St",
    "city": "Chicago",
    "state": "IL"
  },
  "line_items": [
    {
      "inventory_id": 12345,
      "quantity": 2
    }
  ],
  "reference_id": "order-abc-123"
}'

{
  "destination_time_zone": "America/Chicago",
  "errors": [],
  "estimates": [
    {
      "delivery_date": "2026-04-28T00:00:00+00:00",
      "location": {
        "id": 305,
        "name": "Bolingbrook, IL"
      },
      "measurements": {
        "depth_in": 4,
        "length_in": 10,
        "total_weight_oz": 16,
        "width_in": 6
      },
      "order_by_date": "2026-04-24T20:00:00+00:00",
      "packing_material": "Box",
      "shipping_cost": {
        "currency_code": "USD",
        "value": 8.42
      },
      "shipping_service": {
        "id": 12,
        "is_promise": true,
        "name": "UPS Ground",
        "shipping_methods": [
          "Standard",
          "GroundShip"
        ]
      }
    }
  ],
  "reference_id": "order-abc-123"
}

Returns an estimated delivery date for a given destination and set of line items. The destination address must always include zip_code and country. The flow is auto-detected from the request shape: an address with only zip_code and country plus exactly one line item is treated as the Product Details Page (PDP) flow; a full address with one or more line items is treated as the Checkout flow.

Returns an estimated delivery date for a given destination and set of line items. The destination address must always include `zip_code` and `country`. The flow is auto-detected from the request shape: an address with only `zip_code` and `country` plus exactly one line item is treated as the Product Details Page (PDP) flow; a full address with one or more line items is treated as the Checkout flow.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Request

destination_addressobjectRequired

Destination address for a POST /order:estimate-delivery-date request.

line_itemslist of objectsRequired

The items to estimate. For PDP flow, exactly one item is required. For Checkout flow, one or more items are required. Each item must supply either inventory_id or sku.

reference_idstringOptional

Optional. Caller-supplied correlation identifier echoed back in the response.

Response

OK: one of: full success (estimates populated, errors empty), partial success (both populated), or system-can’t-fulfill (empty estimates + one ApiError in errors[]).

destination_time_zonestring

IANA time-zone id of the destination (e.g. America/New_York), best-effort. Serialized as destination_time_zone. Null when it can’t be resolved (non-US destination, unknown zip, or lookup failure) — callers must treat it as optional.

errorslist of objects

Errors encountered while computing partial results. Empty on a fully successful response.

estimateslist of objects

The list of estimates, one per eligible shipping service and fulfillment center combination. Empty when no fulfillment center is available for a PDP request.

reference_idstring

Echoed from the request's ReferenceId for caller correlation. Null if not supplied.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

502

Bad Gateway Error

504

Gateway Timeout Error

Authentication

Headers

Request

Response

Errors