Get Multiple Warehouse Receiving Orders

curl -G https://sandbox-api.shipbob.com/2026-01/receiving \
     -H "Authorization: Bearer <token>" \
     -d IDs=0 \
     -d Statuses=Awaiting \
     --data-urlencode InsertStartDate=2019-08-24T14:15:22+00:00 \
     --data-urlencode InsertEndDate=2019-08-24T14:15:22+00:00 \
     -d FulfillmentCenterIds=0 \
     -d PurchaseOrderNumbers=string \
     -d ExternalSync=true \
     --data-urlencode CompletedStartDate=2019-08-24T14:15:22+00:00 \
     --data-urlencode CompletedEndDate=2019-08-24T14:15:22+00:00

[
  {
    "box_labels_uri": "https://api.shipbob.com/2026-01/receiving/1/labels",
    "box_packaging_type": "EverythingInOneBox",
    "expected_arrival_date": "2019-08-24T14:15:22+00:00",
    "external_sync_timestamp": "2019-08-24T14:15:22+00:00",
    "fulfillment_center": {
      "address1": "5900 W Ogden Ave",
      "address2": "Suite 100",
      "city": "Cicero",
      "country": "USA",
      "email": "example@example.com",
      "id": 0,
      "name": "Cicero (IL)",
      "phone_number": "555-555-5555",
      "state": "IL",
      "timezone": "Central Standard Time",
      "zip_code": "60804"
    },
    "id": 0,
    "insert_date": "2019-08-24T14:15:22+00:00",
    "inventory_quantities": [
      {
        "expected_quantity": 0,
        "inventory_id": 0,
        "received_quantity": 0,
        "sku": "string",
        "stowed_quantity": 0
      }
    ],
    "last_updated_date": "2019-08-24T14:15:22+00:00",
    "package_type": "Package",
    "purchase_order_number": "string",
    "status": "Awaiting",
    "status_history": [
      {
        "id": 0,
        "status": "Processing",
        "timestamp": "2019-08-24T14:15:22+00:00"
      }
    ]
  }
]

Returns a list of warehouse receiving orders with optional filtering by status, fulfillment center, purchase order number, and date range.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Query parameters

PageintegerOptional

Page of WROs to get

LimitintegerOptional

Number of WROs per page to request

IDslist of integersOptional

Comma separated list of WRO IDs to filter by

Statuseslist of enumsOptional

Comma separated list of WRO statuses to filter by

InsertStartDatedatetimeOptional

Earliest date that a WRO was created

InsertEndDatedatetimeOptional

Latest date that a WRO was created

FulfillmentCenterIdslist of integersOptional

Comma separated list of WRO fulfillment center IDs to filter by

PurchaseOrderNumberslist of stringsOptional

Comma separated list of WRO PO numbers to filter by

ExternalSyncbooleanOptional

Flag to return external_sync_timestamp WROs

CompletedStartDatedatetimeOptional

Earliest date that a WRO was completed

CompletedEndDatedatetimeOptional

Latest date that a WRO was completed

Response headers

Page-Numberinteger

Number of the current page

Total-Pagesinteger

Total number of pages of results

Total-Countinteger

Total number of results

Page-Sizeinteger

Number of results per page

Next-PagestringOptional

The href of the next page of results, if there is a next page

Response

Success

box_labels_uristring or nullOptional

URL to the packing slip to be included in each box shipment for this receiving order

box_packaging_typeenumOptional

Allowed values:

expected_arrival_datedatetimeOptional

Expected date that all packages will have arrived. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

external_sync_timestampdatetime or nullOptional

The timestamp in UTC when a 3rd party integrator has set in our system

fulfillment_centerobjectOptional

Information about a fulfillment center

idintegerOptional

Unique id of the warehouse receiving order

insert_datedatetimeOptional

Insert date of the receiving order. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

inventory_quantitieslist of objects or nullOptional

Inventory items and quantities within the WRO

last_updated_datedatetimeOptional

Last date the receiving order was updated. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.

package_typeenumOptional

Allowed values:

purchase_order_numberstring or nullOptional

Purchase order number for a receiving order

statusenumOptional

status_historylist of objects or nullOptional

The history of status changes for this receiving order

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error