Get Order Adjustments

Retrieve all adjustments for all bags in an order given an order_id.

This endpoint returns adjustments from all bags within the order, making it useful for getting a complete picture of all corrections made to an order. Only apps that created the order (matching app_id) can access its adjustments.

Get Order Adjustments

get

Retrieves all adjustments for all bags in an order. Only apps that created the order (matching app_id) can access its adjustments.

Path parameters

order_idinteger · int64Required

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Responses

200

success

application/json

404

Order not found

get

/orders/{order_id}/adjustments

HTTPcURLJavaScriptPython

GET /v1/orders/{order_id}/adjustments HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Accept: */*

[
  {
    "id": 10001,
    "bag_id": 22222,
    "order_id": 11111,
    "merchant_id": 10000,
    "app_id": 10193,
    "entity_type": "SHIPPING_TOTAL",
    "previous_value": 1000,
    "adjusted_value": 500,
    "adjustment_delta": -500,
    "shopper_adjustment": true,
    "shopper_adjustment_amount": -500,
    "merchant_adjustment": false,
    "merchant_adjustment_amount": 0,
    "channel_adjustment": true,
    "channel_adjustment_amount": 500,
    "reason": "Shipping was overcharged due to carrier rate update",
    "date_created": "2024-12-08T15:30:00+0000"
  },
  {
    "id": 10002,
    "bag_id": 22222,
    "order_id": 11111,
    "merchant_id": 10000,
    "app_id": 10193,
    "entity_type": "TAX_TOTAL",
    "previous_value": 850,
    "adjusted_value": 1050,
    "adjustment_delta": 200,
    "shopper_adjustment": true,
    "shopper_adjustment_amount": 200,
    "merchant_adjustment": true,
    "merchant_adjustment_amount": -200,
    "channel_adjustment": false,
    "channel_adjustment_amount": 0,
    "reason": "Tax was miscalculated for customer's jurisdiction",
    "date_created": "2024-12-08T15:35:00+0000"
  }
]