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
      • POSTCreate Order
      • GETGet Orders
      • GETGet Order
      • GETGet Shipment
      • GETGet Shipment Timeline
      • POSTBatch Cancel Shipments
      • POSTMark Tracking Uploaded
      • POSTEstimate Delivery Date
    • OpenAPI spec
LogoLogo
API ReferenceOrders

Estimate Delivery Date

||View as Markdown|
POST
/2026-01/order:estimate-delivery-date
POST
/2026-01/order:estimate-delivery-date
$curl -X POST https://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

Mark Tracking Uploaded

Next

Estimate Fulfillment Cost For Order

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token or OAuth2

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