Update multiple orders

PATCH

/v1/orders/bulk

This API request allows you to send a PATCH request to orders/bulk endpoint and update order data or order items data for multiple orders in a single request.

Note that you need to provide updated values for each order and nest the orders under a bulk array.

Request

Body Params application/json

Examples

Responses

🟢200OK

text/plain

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.dev.ordermesh.io/v1/orders/bulk' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bulk": [
        {
            "id": "65aac2a2441de72442397b62",
            "shippingAddress": {
                "location": null,
                "firstName": "Jane",
                "lastName": "Doe",
                "line1": "123 Maple Street",
                "line2": "",
                "line3": null,
                "city": "Springfield",
                "state": "IL",
                "zip": "62704",
                "countryCode": "US",
                "phone": "555-1234",
                "email": "jane.doe@example.com"
            },
            "billingAddress": {
                "location": null,
                "firstName": "Jane",
                "lastName": "Doe",
                "line1": "123 Maple Street",
                "line2": "",
                "line3": null,
                "city": "Springfield",
                "state": "IL",
                "zip": "62704",
                "countryCode": "US",
                "phone": "555-1234",
                "email": "billing@example.com"
            },
            "returnAddress": null,
            "location": {
                "longitude": -89.64,
                "latitude": 39.78
            },
            "merchantName": "Springfield Boutique",
            "customerShippingMethod": "Expedited",
            "status": "ReadyForFulfillment",
            "items": [
                {
                    "id": "65aac2a2441de72442397b63",
                    "sku": "TSHIRT-5000-M-Black",
                    "quantity": 1,
                    "images": [
                        {
                            "url": "https://example.com/tshirt-front.jpg",
                            "thumbnailUrl": "https://example.com/tshirt-thumbnail.jpg",
                            "thumbnailFileId": null,
                            "area": "Front",
                            "printMethod": "DirectToGarment",
                            "ourUrl": null,
                            "ourFileId": null,
                            "ourThumbnailUrl": null,
                            "ourThumbnailFileId": null,
                            "vendorReadyFileId": null
                        }
                    ],
                    "options": [
                        {
                            "name": "Size",
                            "value": "Medium"
                        },
                        {
                            "name": "Color",
                            "value": "Black"
                        }
                    ],
                    "attributes": [
                        {
                            "name": "Material",
                            "value": "Cotton"
                        }
                    ],
                    "merchantPrice": {
                        "amount": 15,
                        "currency": "USD"
                    },
                    "merchantShippingPrice": {
                        "amount": 2.5,
                        "currency": "USD"
                    },
                    "merchantTax": {
                        "amount": 1.2,
                        "currency": "USD"
                    },
                    "status": null,
                    "statusDesc": null,
                    "skipImgManip": false,
                    "skipImageValidation": false,
                    "skipSkuValidation": false
                }
            ],
            "shipmentsMetadata": null,
            "isPollingStopped": false
        }
    ]
}'

Response Example

200 - Example 1

{
    "bulk": [
        {
            "status": 0,
            "response": null
        }
    ]
}

Modified at 2026-02-27 22:33:53

Retrieve multiple orders

Retrieve a list of orders