{"slug":"handel-halowerk-com-v1-return-disposition-59289f","title":"Takes a list of returns with the figures your own systems already hold and retur","host":"handel.halowerk.com","method":"POST","resource":"https://handel.halowerk.com/v1/return-disposition","category":"other","description":"Takes a list of returns with the figures your own systems already hold and returns one decision per return, with the arithmetic that produced it. Four routes are valued: reselling as is, at the resale value weighted by the probability that it actually sells and less the restocking cost; repairing an","price_listed":0.004,"price_asked":0.004,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1209,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"currency":"EUR","decision_margin_pct":5,"defaults":{"disposal_cost":1.5,"inbound_freight_cost":3.9,"inspection_cost":4.5,"restocking_cost":2},"items":[{"condition":"like_new","refurb_resale_value":199,"repair_cost":35,"repair_success_probability":0.9,"resale_probability":0.95,"resale_value":189,"return_id":"R-1001","salvage_value":12},{"condition":"defective","refurb_resale_value":149,"repair_cost":60,"repair_success_probability":0.7,"resale_probability":0.4,"resale_value":20,"return_id":"R-1002","salvage_value":18},{"condition":"damaged","refurb_resale_value":40,"repair_cost":55,"repair_success_probability":0.5,"resale_probability":0.3,"resale_value":9,"return_id":"R-1003","salvage_value":6}]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"currency":{"default":"EUR","description":"ISO 4217 code for every amount in this request. Not converted, only carried through.","maxLength":3,"minLength":3,"type":"string"},"decision_margin_pct":{"default":5,"description":"How far ahead the best route must be before it counts as a decision. Inside this margin the result is reported as ambiguous instead of asserting a winner.","maximum":100,"minimum":0,"type":"number"},"defaults":{"additionalProperties":false,"description":"Values that apply to every item that does not carry its own. An item value always wins.","properties":{"disposal_cost":{"maximum":100000000,"minimum":0,"type":"number"},"inbound_freight_cost":{"maximum":100000000,"minimum":0,"type":"number"},"inspection_cost":{"maximum":100000000,"minimum":0,"type":"number"},"repair_cost":{"maximum":100000000,"minimum":0,"type":"number"},"repair_success_probability":{"maximum":1,"minimum":0,"type":"number"},"resale_probability":{"maximum":1,"minimum":0,"type":"number"},"restocking_cost":{"maximum":100000000,"minimum":0,"type":"number"}},"type":"object"},"items":{"description":"The returns to decide on. Every amount is in the currency named at document level.","items":{"additionalProperties":false,"properties":{"condition":{"description":"Condition as your inspection recorded it. Passed through unchanged; it does not change the arithmetic.","enum":["new","like_new","used","damaged","defective","unknown"],"type":"string"},"disposal_cost":{"description":"Cost of disposing of the item. Scrapping is a cost, not proceeds.","maximum":100000000,"minimum":0,"type":"number"},"inbound_freight_cost":{"description":"Freight already spent getting the item back. Incurred on every route.","maximum":100000000,"minimum":0,"type":"number"},"inspection_cost":{"description":"Cost of inspecting this return. Incurred on every route and therefore does not change the ranking, only the level.","maximum":100000000,"minimum":0,"type":"number"},"refurb_resale_value":{"description":"Expected proceeds after a successful repair.","maximum":100000000,"minimum":0,"type":"number"},"repair_cost":{"description":"Cost of the repair attempt. Incurred whether or not the repair succeeds.","maximum":100000000,"minimum":0,"type":"number"},"repair_success_probability":{"description":"Probability that the repair succeeds. A failed repair falls back to salvage_value.","maximum":1,"minimum":0,"type":"number"},"resale_probability":{"default":1,"description":"Probability that the as-is resale actually happens within your planning window.","maximum":1,"minimum":0,"type":"number"},"resale_value":{"description":"Expected proceeds from selling the item as it is.","maximum":100000000,"minimum":0,"type":"number"},"restocking_cost":{"description":"Cost of putting the item back into stock. Only charged to the as-is resale route.","maximum":100000000,"minimum":0,"type":"number"},"return_id":{"description":"Your identifier for this return. Must be unique within the request.","maxLength":64,"minLength":1,"type":"string"},"salvage_value":{"description":"Proceeds from parts recovery or material recycling.","maximum":100000000,"minimum":0,"type":"number"}},"required":["return_id"],"type":"object"},"maxItems":500,"minItems":1,"type":"array"}},"required":["items"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.004,"price_match":true,"latency_ms":1209,"error":null}],"description_full":"Takes a list of returns with the figures your own systems already hold and returns one decision per return, with the arithmetic that produced it. Four routes are valued: reselling as is, at the resale value weighted by the probability that it actually sells and less the restocking cost; repairing and reselling, at the refurbished value weighted by the repair success probability plus the salvage value on the failure branch, less the repair cost, which is incurred either way; recovering value…","last_updated":"2026-10-12T15:18:52.335Z","schemes":["exact"]}