import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const orderReturn = await client.orders.returns.create('or_UkLWZg9DAJ', {
  reason_id: 'rar_UkLWZg9DAJ',
  items: [{ fulfillment_item_id: 'fi_UkLWZg9DAJ', quantity: 1 }],
})

spree api post /orders/{order_id}/returns -d '{"reason_id":"rar_UkLWZg9DAJ","items":[{"fulfillment_item_id":"fi_UkLWZg9DAJ","quantity":1}]}'

{
  "id": "ret_gbHJdmfrXB",
  "number": "RET1002",
  "status": "requested",
  "order_id": "or_gbHJdmfrXB",
  "reason_id": null,
  "refund_total": "10.00",
  "refund_tax_total": "0.00",
  "approved_at": null,
  "received_at": null,
  "refunded_at": null,
  "canceled_at": null,
  "external_references": {},
  "memo": "Too small",
  "metadata": {},
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "stock_location_id": "sloc_UkLWZg9DAJ",
  "created_by_id": "adm_UkLWZg9DAJ",
  "created_by_type": "admin_user",
  "refunded_total": "0.00",
  "refundable_total": "10.00",
  "documents": [],
  "labels": [],
  "deliveries": []
}

{
  "error": {
    "code": "processing_error",
    "message": "Only 1 of Product 1792493 can be returned"
  }
}