{
  "x402Version": 2,
  "id": 15348,
  "slug": "15348",
  "resource": "https://handel.halowerk.com/v1/return-disposition",
  "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 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…",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "4000",
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "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"
        }
      },
      "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"
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "handel.halowerk.com",
  "lastUpdated": "2026-08-20T06:44:29.965Z",
  "quality": {
    "calls30d": 1,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-08-20T06:44:29.388Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "handel.halowerk.com",
    "manifest_name": "handel.halowerk.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}