Get Bag Adjustments

Retrieve all adjustments for a specific bag given an order_id and bag_id.

Adjustments are immutable audit records that track corrections to bag totals (shipping, tax, or discount). Only apps that created the bag (matching app_id) can access its adjustments.

Get Bag Adjustments

get

Retrieves all adjustments for a specific bag. Only apps that created the bag (matching app_id) can access its adjustments. Returns an array of BagAdjustment objects, each representing an immutable audit record of a correction to the bag's totals.

Path parameters

order_idinteger · int64Required

ID of the order containing the bag

Example: 11111

bag_idinteger · int64Required

ID of the bag to retrieve adjustments for

Example: 22222

Header parameters

X-Violet-TokenstringRequired

API token for authentication

X-Violet-App-SecretstringRequired

Application secret key

X-Violet-App-Idinteger · int32Required

Application ID

Example: 10000

Responses

200

success

application/json

403

forbidden

application/json

404

not found

application/json

500

internal server error

application/json

get

/orders/{order_id}/bags/{bag_id}/adjustments

HTTPcURLJavaScriptPython

GET /v1/orders/{order_id}/bags/{bag_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"
  }
]