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.

Documentation API Reference

Documentation API Reference

API Reference

API Reference Orders

Bulk Update Shipping Service

||View as Markdown|

PUT

https://sandbox-api.shipbob.com/2026-01/shipment:bulkUpdateShippingService

PUT

/2026-01/shipment:bulkUpdateShippingService

$ curl -X PUT https://sandbox-api.shipbob.com/2026-01/shipment:bulkUpdateShippingService \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "reason": "Merchant request",
>   "requested_shipping_service_id": 5,
>   "shipment_ids": [
>     123456,
>     789012
>   ]
> }'

1 {
2   "summary": {
3     "failed": 0,
4     "successful": 2,
5     "total": 2
6   },
7   "results": [
8     {
9       "error": {},
10       "id": 123456,
11       "is_success": true
12     }
13   ]
14 }

Updates the shipping service for multiple shipments in a single request. The requested_shipping_service_id corresponds to the service_level.id value returned by the Get Shipping Methods endpoint.

Was this page helpful?

Get Shipment by Order ID and Shipment ID

Update Shipment Line Items

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR

AuthorizationBearer

OAuth2 authentication using JWT tokens

Request

reasonstringRequired

Reason for updating the shipping service

requested_shipping_service_idintegerRequired

ID of the shipping service to assign to the shipments

shipment_idslist of longsRequired

List of shipment IDs to update the shipping service for

Response

OK

summaryobject

Summary of the bulk operation results

resultslist of objects

Per-shipment results of the bulk operation

Errors

400

Bad Request Error