For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
      • GETGet Order
      • GETGet Shipment Logs
      • POSTMark Tracking Uploaded
      • GETGet All Shipments for Order
      • GETGet Order Store Data
      • POSTEstimate Fulfillment Cost For Order
      • GETGet Orders
      • POSTCreate Order
      • POSTCancel Shipment
      • POSTCancel Shipment by Order ID and Shipment ID
      • GETGet Shipping Methods
      • POSTCancel Order
      • GETGet Shipment Logs by Order ID and Shipment ID
      • GETGet Shipment Status Timeline by Order ID and Shipment ID
      • GETGet Shipment Timeline
      • GETGet Shipment
      • POSTBatch Cancel Shipments
      • GETGet Shipment by Order ID and Shipment ID
      • PUTBulk Update Shipping Service
      • POSTUpdate Shipment Line Items
      • PUTUpdate Shipment Address
      • GETGet Shipment Line Items
      • GETGet Completely Cancelled Orders
      • POSTEstimate Delivery Date
LogoLogo
API ReferenceOrders

Estimate Delivery Date

||View as Markdown|
POST
https://sandbox-api.shipbob.com/2026-01/order:estimate-delivery-date
POST
/2026-01/order:estimate-delivery-date
$curl -X POST https://sandbox-api.shipbob.com/2026-01/order:estimate-delivery-date \
>     -H "x_correlation_id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "destination_address": {
>    "address1": "123 Main St",
>    "city": "Chicago",
>    "country": "US",
>    "state": "IL",
>    "zip_code": "60601"
>  },
>  "line_items": [
>    {
>      "inventory_id": 12345,
>      "quantity": 2
>    }
>  ],
>  "reference_id": "order-abc-123"
>}'
1{
2  "destination_time_zone": "America/Chicago",
3  "errors": [],
4  "estimates": [
5    {
6      "delivery_date": "2026-04-28T00:00:00+00:00",
7      "location": {
8        "id": 305,
9        "name": "Bolingbrook, IL"
10      },
11      "measurements": {
12        "depth_in": 4,
13        "length_in": 10,
14        "total_weight_oz": 16,
15        "width_in": 6
16      },
17      "order_by_date": "2026-04-24T20:00:00+00:00",
18      "packing_material": "Box",
19      "shipping_cost": {
20        "currency_code": "USD",
21        "value": 8.42
22      },
23      "shipping_service": {
24        "id": 12,
25        "is_promise": true,
26        "name": "UPS Ground",
27        "shipping_methods": [
28          "Standard",
29          "GroundShip"
30        ]
31      }
32    }
33  ],
34  "reference_id": "order-abc-123"
35}

Returns an estimated delivery date for a given destination and set of line items. The flow is auto-detected from the request shape: a ZIP-only address with 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.

Was this page helpful?
Previous

Get Completely Cancelled Orders

Next

Set ExternalSync flag for Wros

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Headers

x_correlation_idstringOptionalformat: "uuid"

Optional caller-supplied correlation id (UUID) echoed back in the response and logs for end-to-end request tracing. If omitted, the request is still processed; supplying one makes it easier to correlate this call across ShipBob systems.

Request

destination_addressobjectOptional

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

line_itemslist of objectsOptional

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.

location_idintegerOptional

Optional. Pin the estimate to a specific fulfillment center (location). When omitted, the fulfillment center is resolved via soft inventory allocation.

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