Webhooks Reference

Return Complete

Emitted when all of the lines in a return have completed grading and the return has been closed

{
  "id": "c67e3019-61f6-43cf-97a0-f1b4cc286e46",
  "event_type": "return-complete",
  "event_data": {
        "captured_rma": null,
        "comments": null,
        "completed_at": "2024-11-08T15:16:18.055611Z",
        "customer": {
            "email": "[email protected]",
	          "first_name": "Demo",
						"full_name": "Demo Customer",
            "last_name": "Customer",
            "tags": null
        },
    	  "grading_status": "complete",
				"kind": "production",
        "line_items": [
            {
              	"id": "70007202-eec9-4d10-accb-9e40e35a5ad7",
				      	"3pl": {
         	 				"id": "a3cbee36-2dab-3162-0bd2-221bcad231b",
          				"name": "Two Boxes Demo 3PL"
        				},
	              "barcode": "810047100256",
								"captured_lpn": null,
                "carrier": null,
                "child_reason": "Not correct style",
                "comments": null,
                "consolidation_code": null,
                "consolidation_provider": null,
              	"disposition": "Dispose",
								"expected_quantity": 1,	
                "expiration_date": null,
                "graded_attributes": [
                    {
                        "id": "a586c3dd-22f2-4c51-a3c4-80de92b43d41",
                        "merchant_grading_attribute": {
                            "id": "ec98b9a1-42c6-4781-a1bb-00f9052725c6",
                            "grading_attribute": {
                                "id": "d313cf6c-a233-4ef0-aa5f-c55164076dd0",
                                "title": "Major stain"
                            },
                            "mga_type": "inspection",
                          	"vas_definition": {
                                "id": "145fb7a6-a4b2-4555-b4ba-d16a58089345",
                                "instructions": "Replace Bag",
                                "title": "Replace Bag"
                            }
                        },
                        "vas_successful": true
                    }
                ],
              	"grading_ended_at": null,
								"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-00000535",
                "merchant": {
                    "id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
                },
                "parent_reason": "Not as Described",
                "product_variant": {
                    "barcode": "810047100256",
                    "id": "fb9426bd-6427-44a4-9452-1b4a47b73734",
                    "name": "Spark Half-Zip - Purple / XL",
                    "sku": "XL-SHZ-PUR"
                },
	              "put_away_bin": "1-A-01",
								"quantity": 1,	
                "rma_line_item_id": "7daad0e2-e12c-4257-8546-3582ac750848",
                "site": {
                    "id": "f01bee36-b5bb-4464-a03d-157217f33a92",
                    "name": "Two Boxes Demo"
                },
                "sku": "XL-SHZ-PUR",
                "storefront_line_item_id": "505f74bf-6a92-4472-9e73-7a07c20630e4",
                "storefront_order_id": "order265",
                "storefront_order_name": "order265",
                "storefront_order_number": "order265",
                "storefront_product_id": null,
                "storefront_variant_id": "9887833924",
                "tracking_number": "ups4296100888265",
                "transform_sku": "C-XL-SHZ-PUR",
                "transform_upc": "C-810047100256",
                "upc": null,
                "work_capture": false
            },
            {
                "id": "a605020d-f935-45a8-b480-785ca60d3ce8",
                "barcode": "810140621320",
                "carrier": null,
                "child_reason": "Didn't Fit",
                "comments": null,
                "consolidation_code": null,
                "consolidation_provider": null,
              	"disposition": "Return to Stock",
								"expected_quantity": 1,	
                "expiration_date": null,
                "graded_attributes": [
                    {
                        "id": "d29ce4ae-8fa1-4f66-95b9-cb2ae7b46950",
                        "merchant_grading_attribute": {
                            "id": "defbd999-5f2c-4566-abb3-759d2955a69d",
                            "grading_attribute": {
                                "id": "fba99f3a-9508-425f-8652-320047990a25",
                                "title": "Old Outsole"
                            },
                            "mga_type": "inspection",
                          	"vas_definition": null,
                        },
                        "vas_successful": false
                    }
                ],
              	"grading_ended_at": null,
								"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-00000536",
                "merchant": {
                    "id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
                },
                "parent_reason": "Wrong Item",
                "product_variant": {
                    "barcode": "810140621320",
                    "id": "e58c2168-7323-4a3f-b800-2f0dd5d4cb85",
                    "name": "The Original (Coffee) - 13 / Standard",
                    "sku": "5605225132878"
                },
              	"put_away_bin": "1-A-01",
								"quantity": 1,	
                "rma_line_item_id": "f91a3ad5-f8c1-4851-afc8-a314ad7d3cca",
                "site": {
                    "id": "f01bee36-b5bb-4464-a03d-157217f33a92",
                    "name": "Two Boxes Demo"
                },
                "sku": "5605225132878",
                "storefront_line_item_id": "848862ea-7e32-4992-ab15-54bb20e651ea",
                "storefront_order_id": "order265",
                "storefront_order_name": "order265",
                "storefront_order_number": "order265",
                "storefront_product_id": null,
                "storefront_variant_id": "44840201322728",
                "tracking_number": "ups4296100888265",
                "transform_sku": null,
                "transform_upc": null,
                "upc": null,
                "work_capture": false
            },
            {
                "id": "df6ca411-b9b8-484b-bc2e-c5416e22ec6f",
                "barcode": "760537081759",
                "carrier": null,
                "child_reason": "Wrong Size",
                "comments": null,
                "consolidation_code": null,
                "consolidation_provider": null,
              	"disposition": "Dispose",
								"expected_quantity": 1,	
                "expiration_date": null,
                "graded_attributes": [
                    {
                        "id": "c4249d5b-ca44-4f88-a1cd-bdcdda43506a",
                        "merchant_grading_attribute": {
                            "id": "76e175ef-fe46-4463-a323-99cd7620182a",
                            "grading_attribute": {
                                "id": "c6772f60-18d5-4480-9fc5-1484df912748",
                                "title": "Smell"
                            },
                            "mga_type": "inspection",
                          	"vas_definition": null,
                        },
                        "vas_successful": false
                    }
                ],
              	"grading_ended_at": null,
								"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-00000537",
                "merchant": {
                    "id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
                },
                "parent_reason": "Unhappy with purchase",
                "product_variant": {
                    "barcode": "760537081759",
                    "id": "fa1eeedc-c7ce-4788-bcef-a7cfd90ea769",
                    "name": "Elevation Ball Cap™ - Black",
                    "sku": "FW17-LH-HU-BLK"
                },
	              "put_away_bin": "1-A-01",
								"quantity": 1,	
             	  "rma_line_item_id": "1970a352-19c2-426b-b2c5-dac0a6c2a37e",
             		"site": {
                    "id": "f01bee36-b5bb-4464-a03d-157217f33a92",
                    "name": "Two Boxes Demo"
                },
                "sku": "FW17-LH-HU-BLK",
                "storefront_line_item_id": "7a442f5a-dd2f-4379-a3e3-541e2595a4fc",
                "storefront_order_id": "order265}",
                "storefront_order_name": "order265",
                "storefront_order_number": "order265",
                "storefront_product_id": null,
                "storefront_variant_id": "3447346200589",
                "tracking_number": "ups4296100888265",
                "transform_sku": "C-FW17-LH-HU-BLK",
                "transform_upc": "C-760537081759",
                "upc": null,
                "work_capture": false
            }
        ],
    		"linked_line_items": [],
    		"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"
        },
				// 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"
            }
        },
				//
    		"return_provider": "webhooks",
        "return_type": "rma",
        "rma": "rma265",
        "rma_address": {
            "address_1": "",
            "address_2": null,
            "city": null,
            "company": null,
            "country_code": null,
            "phone_number": null,
            "province_code": null,
            "zip": ""
        },
        "rma_return_id": "25efe7bd-0d59-4bc8-9d2d-fdc8299b694b",
        "rts": false,
        "store_front_provider": "noop",
        "undeliverable_shipping_charge": null,
        "work_capture": false
    }
}