US & EMEA Markets: Get Review Decisions API (NEW)

资料正文

§1 US & EMEA Markets: Get Review Decisions API (NEW)

US & EMEA Markets: Get Review Decisions API (NEW)

Effective date: Aug 24, 2026

§2 What's changing

What's changing

For returns decision management, TikTok has released a new endpoint called Get Review Decisions API, which allows sellers to evaluate which seller decisions are currently allowed for the specified aftersales request. The API returns one result per requested decision, including whether the decision is currently eligible and any rejection reasons that are applicable for an eligible reject decision.

How is this different from the existing Get Decisions Eligibility API? Historically, when a buyer submits a return with multiple sku_id(s), TikTok would not create a unified return_id that included both skus. TikTok decouples each unique sku_id into a separate return_id. Recently we built a new workflow and API to shield sellers/partner systems from this decoupling return_id behavior, and to expose an RMA_ID that represents a "parent" value, with all unique sku_id and their quantities as unique return_line_item_id(s) in a single unified payload. (see batch return ARD documentation here to learn full details about this use-case)

The legacy Get Decisions Eligibility API requires sellers to make multiple API calls for each unique sku_id level return_id.

The new Get Review Decisions API allows sellers to query using the new batch return parent RMA_ID as a search parameter, and the response will include every single sku associated with the buyers original return submission, and the seller can see all possible review decisions that are eligible in the single response payload.

§3 Impact

This is a brand new API, which includes the same functionality as the legacy Get Decisions Eligibility API, but now simplifies the use-case when sellers are using our new batch return RMA APIs. There is no immediate plan this year to deprecate the Get Decisions Eligibility API, but at some point in the future there will be an announcement of the sunset plan. We highly encourage all seller/developers to use the Get Review Decisions API going forward if they need to check decision options for a specific return/Aftersales request.

Impacted Markets	* United States (US) * EU and UK
Returns APIs	Parameter / Feature Update
---	---
Get Review Decisions API	Query Parameter: `return_or_cancel_id` Sellers can still use the legacy TTS `return_id` which is sku_id based Sellers can now also use the batch RMA `id` which will give a comprehensive view of all `sku_id`(s) associated with the buyers original return submission and break out eligible decisions for each unique `return_line_item_id`

§4 FAQ

Question 1: Is this a breaking change? Answer: No. This is a new API endpoint with added query functionality. Existing integrations using the Get Decision Eligibility API will continue to work for now, until the future state sunsetting plan is announced.

Question 2: Does my app need a new authorization scope? Answer: Apps that already have access to the Return & Refund Basic scopes do not need new authorization.