---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Updates one or more order attributes across multiple orders at once.…
    Reference for the POST /shops/{shop_id}/orders/updaters endpoint in the
    Bolder API v1.
sidebar:
  label: Batch update orders
  badge: POST
title: Batch update orders
type: openapi-operation
---
Updates one or more order attributes across multiple orders at once. Currently supports
updating `status`. The operation is not transactional — orders that fail validation are
reported in `invalid_items` while successfully updated ones appear in `valid_items`.
Requires `admin` scope.

`POST /shops/{shop_id}/orders/updaters`

**Request body** (`application/json`, required)

- `ids` (integer[], required) — Array of order IDs to update
- `additions` (object, required) — Attributes to apply to all orders

Request body example:

```json
{
  "ids": [
    577048,
    12001
  ],
  "additions": {
    "status": "shipped"
  }
}
```

**Responses**

- `200` — Batch update result

Response example, 200:

```json
{
  "ids": [
    0
  ],
  "additions": {},
  "removals": {},
  "_embedded": {
    "valid_items": [
      {
        "id": 0,
        "shop_id": 0,
        "code": "string",
        "status": "checkout",
        "net_total": 0,
        "total": 0,
        "shipping_total": 0,
        "shipping_description": "string",
        "discount_total": 0,
        "tracking_code": "string",
        "courier_name": "string",
        "total_weight_in_grams": 0,
        "created_on": "2019-08-24T14:15:22Z",
        "updated_on": "2019-08-24T14:15:22Z",
        "pending_on": "2019-08-24T14:15:22Z",
        "closed_on": "2019-08-24T14:15:22Z",
        "shipped_on": "2019-08-24T14:15:22Z",
        "fulfillment": {
          "fulfillment_method": "shipping"
        },
        "payment_info": {
          "type": "string",
          "name": "string",
          "auth_code": "string",
          "transaction_id": "string"
        },
        "_links": {}
      }
    ],
    "invalid_items": [
      {}
    ]
  }
}
```