Get Available Review Decisions

GET

/return_refund/202606/review_decision

Description of [GET]/return_refund/:version/Get_Review_Decision

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

seller_id

required

integer format: int64

The unique identifier of the seller/shop

return_or_cancel_id

required

string

The identifier of the aftersales request to evaluate. Pass a reverse main order ID, aftersales request ID, or return merchandise authorization (RMA) ID; the API detects which type was provided. Do not pass an order ID or order line ID.

locale

string

The BCP-47 locale codes for displaying the return reason, delimited by commas. Default: en-US Refer to Locale codes for the list of supported locale codes.

check_decisions

Array<string>

Allowed values: APPROVE_REQUEST_CANCEL APPROVE_REFUND APPROVE_RETURN APPROVE_RECEIVED_PACKAGE APPROVE_REPLACEMENT ISSUE_REPLACEMENT_REFUND DIRECT_REFUND REJECT_REQUEST_CANCEL REJECT_REFUND REJECT_RETURN REJECT_RECEIVED_PACKAGE REJECT_REPLACEMENT ISSUE_EXCHANGE_REFUND OFFER_PARTIAL_REFUND OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG

The seller decisions to evaluate for the specified aftersales request. Possible values:

• APPROVE_REQUEST_CANCEL
• APPROVE_REFUND
• APPROVE_RETURN
• APPROVE_RECEIVED_PACKAGE
• APPROVE_REPLACEMENT
• ISSUE_REPLACEMENT_REFUND
• DIRECT_REFUND
• REJECT_REQUEST_CANCEL
• REJECT_REFUND
• REJECT_RETURN
• REJECT_RECEIVED_PACKAGE
• REJECT_REPLACEMENT
• ISSUE_EXCHANGE_REFUND
• OFFER_PARTIAL_REFUND
• OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG Note: When omitted, the API evaluates all supported seller decisions for the request and returns one result per decision.

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

line_items

Line items to which the returned decisions apply. Decision details apply to each line item individually. For example, a partial refund amount of 1.00 for each of three line items results in a total of 3.00; use the currency returned with the amount range rather than assuming a currency.

Array<object>

object

return_line_item_id

Unique identifier for this item in the return. In the case of virtual bundle, this corresponds to the id of the original parent item bundle.

string

sub_return_line_item_id

Unique identifier for this item in the return. In the case of virtual bundle, this corresponds to the id of the current child item being returned.

string

decisions

The list of candidate review decisions for this line item.

Array<object>

object

decision

Seller review decision evaluated for this line item. Possible values:

• APPROVE_REQUEST_CANCEL
• APPROVE_REFUND
• APPROVE_RETURN
• APPROVE_RECEIVED_PACKAGE
• APPROVE_REPLACEMENT
• ISSUE_REPLACEMENT_REFUND
• DIRECT_REFUND
• REJECT_REQUEST_CANCEL
• REJECT_REFUND
• REJECT_RETURN
• REJECT_RECEIVED_PACKAGE
• REJECT_REPLACEMENT
• ISSUE_EXCHANGE_REFUND
• OFFER_PARTIAL_REFUND
• OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG

string

Allowed values: APPROVE_REQUEST_CANCEL APPROVE_REFUND APPROVE_RETURN APPROVE_RECEIVED_PACKAGE APPROVE_REPLACEMENT ISSUE_REPLACEMENT_REFUND DIRECT_REFUND REJECT_REQUEST_CANCEL REJECT_REFUND REJECT_RETURN REJECT_RECEIVED_PACKAGE REJECT_REPLACEMENT ISSUE_EXCHANGE_REFUND OFFER_PARTIAL_REFUND OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG

eligible

Whether this decision is currently eligible for the line item. When false, ineligible_code and ineligible_reason explain why the decision is ineligible; these fields are omitted when true.

boolean

ineligible_code

The reason code for an ineligible decision.

integer format: int64

ineligible_reason

The reason for an ineligible decision.

string

available_reject_reasons

Rejection reasons, if available, for this eligible decision. Each item contains a machine-readable name and display text.

Array<object>

object

name

The machine-readable name of the rejection reason to pass as the rejection-reason identifier in the applicable review or reject request.

string

text

The display text for the rejection reason.

string

partial_refund_amount_range

The allowed partial refund amount band. Returned for the OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG decision when it is eligible; omitted for all other decisions.

object

min_amount

The minimum partial refund amount the seller may offer.

string

max_amount

The maximum partial refund amount the seller may offer.

string

currency

The currency of the partial refund amount range, matching the currency of the current return request.

string

request_log_id

The log id of this request, used for troubleshooting with TikTok Shop support.

string

errors

Lists errors for partially failed requests. For example, if a request reviews multiple orders or items and only some fail, individual error details are returned here. IMPORTANT: Partial failures still return a top-level success code (0), so clients must also check this field to detect partial errors. For complete failures (e.g. validation errors), the top-level response code and message will indicate a failure, but this field will remain empty.

Array<object>

object

code

Error Code

string

message

Error Description

string

Example

{
  "code": 0,
  "data": {
    "line_items": [
      {
        "return_line_item_id": "4035319218955782461",
        "sub_return_line_item_id": "4035227657962164815",
        "decisions": [
          {
            "decision": "OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG",
            "eligible": false,
            "ineligible_code": 25005020,
            "ineligible_reason": "the return is already completed, you can't approve again.",
            "available_reject_reasons": [
              {
                "name": "seller_reject_apply_product_has_been_packed",
                "text": "The display text for the reject reason."
              }
            ],
            "partial_refund_amount_range": {
              "min_amount": "2.34",
              "max_amount": "3.33",
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "request_log_id": "20260713225708FB…",
    "errors": [
      {
        "code": "98001004",
        "message": "Invalid parameters. Please verify your input before retrying"
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}