Update details of a specific shipment by Shipment ID.

PATCH

/v1/{shipmentId}

Request

Path Params

Body Params application/json

Examples

Responses

🟢204No Content

Returns success when the shipment is updated.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.dev.ordermesh.io/v1/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orderItems": [
        {
            "id": "a1f0a9cc-f66c-447f-b770-9b4884e9f02d",
            "vendorSku": "Test variant sku name",
            "variantId": "1",
            "vendorProductId": "1",
            "sku": "Test sku name",
            "quantity": 1,
            "price": {
                "currency": "USD",
                "amount": 10,
                "tax": 5
            },
            "merchantPrice": {
                "currency": "USD",
                "amount": 10,
                "tax": 5
            }
        }
    ],
    "shipmentStatus": 4,
    "shipmentUpdateData": "{\"shippingMethod\":\"Express\"}",
    "shippingMethod": null,
    "isPollingStopped": true,
    "merchantOrderTotal": 20,
    "merchantPackageTotal": 20,
    "merchantTaxTotal": 50,
    "merchantShippingTotal": 20,
    "packageTotal": 10,
    "taxTotal": 50,
    "shippingTotal": 20,
    "total": 150,
    "costTotal": 100,
    "costTaxTotal": 10,
    "costShippingTotal": 100,
    "costShippingTaxTotal": 30,
    "orderExternalId": null,
    "selectedShippingMapping": {
        "carrierName": "UPS",
        "type": "Detailed",
        "shippingMethods": [
            {
                "shippingMethodName": null,
                "shipmentMethod": "Standard",
                "vendorShippingMethod": null,
                "shipToCountries": null,
                "carrierShippingServiceMethods": [
                    {
                        "serviceMethodsAllowed": [
                            "Ground"
                        ],
                        "countryCodesToApply": [
                            "US"
                        ],
                        "vendorMapping": {
                            "carrierCode": "UPS",
                            "serviceCode": "Ground"
                        }
                    }
                ]
            }
        ]
    }
}'

Response Example

400 - Success Example

{
    "errorCode": "ValidationError",
    "requestId": "224b67bd-02e2-4b0c-9eef-2559e51d1866",
    "errors": [
        {
            "errorMessage": "'Title' must not be empty.",
            "propertyName": "'Title'",
            "attemptedValue": null
        }
    ]
}

Modified at 2026-03-02 17:34:25

Get details of a specific shipment by Shipment ID.

Create packages for a specific shipment.