# Returns

## v2-acceptReturn - Accept or refuse return

 - [PUT /v2/orders/returns/{return_id}/accept](https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/returns/v2-acceptreturn.md): Use this API to accept or refuse a return that is in the REQUEST_INITIATED status, from Mirakl Connect. The API also synchronizes the return status on the sales channel.Call FrequencyRecommended usage: On each new returnMaximum usage: On each new return

## v2-acknowledgeReturnReception - Mark return as received

 - [PUT /v2/orders/returns/{return_id}/receive](https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/returns/v2-acknowledgereturnreception.md): Use this API to marks the return as received to officially confirm physical reception of the item from the customer. The API also synchronizes the return status on the sales channel.Call FrequencyRecommended usage: On each new returnMaximum usage: On each new return

## v2-closeReturn - Mark return as closed

 - [PUT /v2/orders/returns/{return_id}/close](https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/returns/v2-closereturn.md): Use this API to marks the return as closed after all necessary steps required by the marketplace or seller’s process are completed (e.g., refund, compliance check, restocking). The API also synchronizes the return status on the sales channel.Call FrequencyRecommended usage: On each new returnMaximum usage: On each new return

## v2-listReturns - List Mirakl Connect returns

 - [GET /v2/orders/returns](https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/returns/v2-listreturns.md): Use this API to synchronize Mirakl Connect returns with your system. We recommend integrating this API in asynchronous mode. You can retrieve all returns updated since the last call, and update your referential accordingly. To do so, schedule a task that calls this API using the updated_from parameter valued with the last execution time of the task.Call FrequencyRecommended usage: Asynchronous: every 5 minutesMaximum usage: Asynchronous: once per minutePaginationThis resource supports seek pagination (see documentation)Sort fieldssort field can have the following values:updated_at (Default) - Sort by date time of last return modification in Mirakl Connect (desc by default)

## v2-updateReturnTrackingInformation - Update return tracking information

 - [PUT /v2/orders/returns/{return_id}/trackings](https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/returns/v2-updatereturntrackinginformation.md): Use this API to update the tracking information of a return from Mirakl Connect. The API also updates the return tracking information on the sales channel.Call FrequencyRecommended usage: On each new returnMaximum usage: On each new return