Update Return Status

curl --request PUT \
  --url https://api.getredo.com/v2.2/returns/{returnId}/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "open"
}
'

{
  "detail": "<string>",
  "instance": "<string>",
  "title": "<string>",
  "type": "about:blank"
}

Returns

Update Return Status

Update return status.

Certain status transitions trigger additional side effects to maintain data consistency:

Setting status to complete will also mark all return items as complete.
Setting status to open from complete or rejected will reopen the return, resetting all processed/rejected items back to open, clearing pending processing info, resetting the expiration date, and marking the return as reopened. Note: Reopening a processed return does not reverse any refunds, exchanges, or other actions that were performed during processing.

PUT

returns

{returnId}

status

Update Return Status

curl --request PUT \
  --url https://api.getredo.com/v2.2/returns/{returnId}/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "open"
}
'

{
  "detail": "<string>",
  "instance": "<string>",
  "title": "<string>",
  "type": "about:blank"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

returnId

string

required

Return ID

Example:

"64e4d5e837572a4813b73e40"

Body

application/json

status

enum<string>

required

Return status.

complete: The return has been completed successfully.
open: Return has been approved and is awaiting shipment.
flagged: A problem with return processing requires merchant action.
rejected: The return has been rejected.
deleted: The return has been reset.

Available options:

complete,

open,

flagged,

rejected,

deleted

Example:

"open"

Response

Updated

Return Status

List Returns