Emitted when a new line is added to a return. This is can be triggered when a new item is added to a work capture return, when a new line is added to a bulk-return or when an unexpected item is added to a RMA return.
{
"id": "c67e3019-61f6-43cf-97a0-f1b4cc286e46",
"event_type": "return-line-item-added",
"event_data": {
"line_item": {
"id": "f3a25cc5-6e2c-4c79-a6e7-eb5c2c99a143",
"3pl": {
"id": "a3cbee36-2dab-3162-0bd2-221bcad231b",
"name": "Two Boxes Demo 3PL"
},
"barcode": "810047100843",
"captured_lpn": null,
"carrier": null,
"child_reason": null,
"comments": null,
"consolidation_code": null,
"consolidation_provider": null,
"disposition": "Return to Stock",
"expected_quantity": 1,
"expiration_date": null,
"graded_attributes": [
{
"id": "944b204c-37a6-43f7-93f8-bbd9c1b8d02a",
"merchant_grading_attribute": {
"id": "d7d2b33d-954c-4ee4-ac3f-49a6d0a9027c",
"grading_attribute": {
"id": "3dd0ffb8-ba8e-4a2c-8d6d-9863812902a4",
"title": "No defects"
},
"mga_type": "inspection",
"vas_definition": null
},
"vas_successful": null
}
],
"grading_ended_at": null,
"return_line_item_grading_status": "graded",
"links": {
"actions": null,
"portal": "https://portal.twoboxes.com/3pls/5c949afb-e493-4b67-a7fd-8d5928d23ee7/returns/a8006401-43d7-4365-b642-0b9eff0c6071",
"self": "https://api.twoboxes.io/api/v1/returns/a8006401-43d7-4365-b642-0b9eff0c6071/line-items/0c3259db-2d97-4325-bcf6-f2893148f3cf""
},
"lot_code": null,
"lpn": "TB-00000751",
"merchant": {
"id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
},
"parent_reason": null,
"product_variant": {
"barcode": "810047100843",
"id": "a66818e5-89b3-438e-80d5-c312496c2ce9",
"name": "Connect T-Shirt Dress - Pink/Reflex Blue / 3XL",
"sku": "3XL-CTD-PNKBLU"
},
"put_away_bin": "1-A-01",
"quantity": 1,
"rma_line_item_id": "1a270443-ec68-4005-add6-58e1a0118c38",
"site": {
"id": "f01bee36-b5bb-4464-a03d-157217f33a92",
"name": "Two Boxes Demo"
},
"sku": "3XL-CTD-PNKBLU",
"storefront_line_item_id": "",
"storefront_order_id": null,
"storefront_order_name": null,
"storefront_order_number": null,
"storefront_product_id": null,
"storefront_variant_id": null,
"tracking_number": null,
"transform_sku": null,
"transform_upc": null,
"upc": null,
"work_capture": true
},
"return": {
"captured_rma": "RMA1234",
"id": "5cacf9bb-1fbb-4fda-8f44-e2b9b08647e2",
// BEING DEPRECATED DEC 30, 2025
"merchant_integration": {
"id": "c1b14fad-b84f-4f08-bb79-322d4a645976",
"merchant": {
"id": "fb31bc87-6397-468c-8e65-4de80f020c02",
"name": "Two Boxes Demo"
},
"name": "Two Boxes Demo",
"site": {
"id": "4f85a652-5cf8-473f-8b12-582249b4c881",
"name": "Demos"
}
},
//
"rma": "6eWsHRsdpetDjMaXALLh",
"rma_return_id": ""
}
}
}