Reopen a Return

Reopen a canceled or declined return (RMA) request back to Pending — but only when the store's settings allow customers to reopen returns. If reopening is disabled, the endpoint returns HTTP 400. The response carries the updated return.

Endpoint

POST /api/shop/returns/{id}/reopen

Authentication

This endpoint requires an authenticated customer — send the storefront key and a customer Bearer token. See the Authentication page.

Request Headers

Header	Required	Description
Content-Type	Yes	application/json
X-STOREFRONT-KEY	Yes	Your storefront API key
Authorization	Yes	Bearer token (customer login required)

Path Parameters

Parameter	Type	Required	Description
id	integer	Yes	Id of the return to reopen. Must belong to the authenticated customer.

Request Body

No body is required — send an empty body.

Response Fields (200 OK)

Field	Type	Description
id	integer	Return ID.
orderId	integer	Id of the order the item belongs to.
orderIncrementId	string	Human-readable order number.
statusId	integer	Numeric status id after the reopen — 1 (Pending).
statusTitle	string	Status label.
statusColor	string	Hex color for the status badge.
canClose	boolean	Whether the return can be closed.
canReopen	boolean	Whether the return can be reopened.
isExpired	boolean	Whether the return is past its action window.
messagesCount	integer	Number of conversation messages on the return.
updatedAt	string	ISO 8601 last update timestamp.

Status Codes

Status	Meaning
200 OK	Return reopened.
400 Bad Request	Reopening is disabled in the store's settings.
401 Unauthorized	Missing or invalid storefront key.
403 Forbidden	Missing or invalid customer Bearer token.
404 Not Found	The return does not exist or is not the customer's.

Related Resources

• Cancel a Return — withdraw a return the customer raised
• Close a Return — mark a return solved
• Returns Overview — the returns menu overview, including the settings that gate it