OTTO Market API documentation

Returns Interface

After you have sent the product to the customer, but the customer has unfortunately decided not to keep it, this Returns Interface allows you to report the return.

In principle, you will accept a return, so that we can trigger the customer payment immediately. It would be great if you would also inform us about the condition of the return.

In the rare case (e.g. if the return does not correspond to the correct article) that you do not want to accept a return, you also have the option to reject the return. In this case we would like to receive a reason in addition to the condition of the return.

We expect the following values for the condition:

  • A for "in original packaging"
  • B for "in mint condition"
  • C for "slightly used"
  • D for "heavily used"
  • E for "mistake (Delivery incomplete, not available,...)"

If you have already accepted a return, it cannot be rejected again afterwards. However, if you feel you have changed your mind about a rejected return, you still have the option to accept the return afterwards.


This changelog will document all relevant changes in our interface. Kudos to

Status: Released



  • get api /v2/returns to view returns announced by customer and misdirected at otto warehouse.



  • get api /v2/returns to view returns accepted and return rejected by customer.
Imprint | Privacy policy | Datenschutz