Returns

Permission: returns (read). Filtered to the locations the key can see.

GET /v1/returns. Filters: order_id, customer_id, source (sale or online), location_id, updated_since (on creation time), limit, cursor.

GET /v1/returns/{id}

{
  "object": "return",
  "id": 310,
  "number": "R93-000012",
  "source": "sale",
  "order_id": 5521,
  "bigcommerce_order_id": null,
  "location_id": 93,
  "customer_id": 1166,
  "settlement": "refund",
  "refund_tender": "card",
  "items_cents": 1599,
  "tax_cents": 116,
  "restock_fee_cents": 0,
  "total_cents": 1715,
  "reason": "Wrong caliber",
  "lines": [
    { "object": "return_line", "id": 402, "order_line_id": 9801, "product_id": 2062, "sku": "AMM-9-115-50", "description": "Blazer Brass 9mm 115gr FMJ (50)", "qty": 1, "unit_price_cents": 1599, "tax_cents": 116, "line_total_cents": 1715, "condition": "restock", "restocked": true }
  ],
  "created_at": "2026-09-25T15:02:00Z"
}

Field	Values
settlement	refund, store_credit, exchange
source	sale means a return of a POS order (order_id set); online means a BigCommerce order (bigcommerce_order_id set)
lines[].condition	restock or damaged