---
title: "One order's price breakdown, live from TikTok"
method: GET
path: "/orders/{order_id}/price_detail"
tags: ["Orders"]
---

# One order's price breakdown, live from TikTok

`GET /orders/{order_id}/price_detail`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/orders/{order_id}/price_detail`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

List price, sale price, seller and platform deductions, vouchers, shipping, tax and payment for one order and for each line, as TikTok calculates them. Each line names the seller-funded promotions applied to it (`seller_funded_product_promotions` / `seller_funded_shipping_promotions`: activity or coupon id, discount amount, COUPON or ACTIVITY), which ties an order to the activities under `/promotions`. Amounts are decimal strings exactly as TikTok sends them. Nothing is stored. An order that is not this shop's answers 404, the same as one that does not exist. Requires the shop's TikTok grant to carry `seller.order.info`.

## Path parameters

- `order_id` string, required

## Response `200`

Successful Response

- OrderPriceDetailResponse: One order's price breakdown, live from TikTok.
  - `shop_id` integer, required
  - `data` OrderPriceDetailOut, required
    - `currency` string, nullable
    - `total` string, nullable: sku_list_price + shipping_list_price.
    - `payment` string, nullable: What the buyer paid.
    - `sku_list_price` string, nullable
    - `sku_sale_price` string, nullable: sku_list_price - subtotal_deduction_seller - subtotal_deduction_platform.
    - `subtotal` string, nullable
    - `subtotal_deduction_seller` string, nullable
    - `subtotal_deduction_platform` string, nullable
    - `subtotal_tax_amount` string, nullable
    - `voucher_deduction_seller` string, nullable: Seller voucher discount amount (an amount in live responses, though TikTok's spec text calls it a type).
    - `voucher_deduction_platform` string, nullable: Platform voucher discount amount.
    - `shipping_list_price` string, nullable
    - `shipping_sale_price` string, nullable
    - `shipping_fee_deduction_seller` string, nullable
    - `shipping_fee_deduction_platform` string, nullable
    - `shipping_fee_deduction_platform_voucher` string, nullable
    - `tax_amount` string, nullable
    - `tax_rate` string, nullable: Line items only, e.g. 0.0825.
    - `net_price_amount` string, nullable
    - `sku_gift_original_price` string, nullable: Gift-with-purchase item's list price; line items only.
    - `sku_gift_net_price` string, nullable: Gift-with-purchase item's list price with tax; line items only.
    - `order_id` string, required
    - `line_items` OrderPriceLineItemOut[]
      - `currency` string, nullable
      - `total` string, nullable: sku_list_price + shipping_list_price.
      - `payment` string, nullable: What the buyer paid.
      - `sku_list_price` string, nullable
      - `sku_sale_price` string, nullable: sku_list_price - subtotal_deduction_seller - subtotal_deduction_platform.
      - `subtotal` string, nullable
      - `subtotal_deduction_seller` string, nullable
      - `subtotal_deduction_platform` string, nullable
      - `subtotal_tax_amount` string, nullable
      - `voucher_deduction_seller` string, nullable: Seller voucher discount amount (an amount in live responses, though TikTok's spec text calls it a type).
      - `voucher_deduction_platform` string, nullable: Platform voucher discount amount.
      - `shipping_list_price` string, nullable
      - `shipping_sale_price` string, nullable
      - `shipping_fee_deduction_seller` string, nullable
      - `shipping_fee_deduction_platform` string, nullable
      - `shipping_fee_deduction_platform_voucher` string, nullable
      - `tax_amount` string, nullable
      - `tax_rate` string, nullable: Line items only, e.g. 0.0825.
      - `net_price_amount` string, nullable
      - `sku_gift_original_price` string, nullable: Gift-with-purchase item's list price; line items only.
      - `sku_gift_net_price` string, nullable: Gift-with-purchase item's list price with tax; line items only.
      - `line_item_id` string, required
      - `seller_funded_product_promotions` OrderPricePromotionOut[]: Promotions the seller funded on the product price; empty when TikTok names none.
        - `activity_id` string, required: Promotion activity or coupon id.
        - `discount_amount` string, nullable: Decimal string, as TikTok sends it.
        - `discount_type` string, nullable: COUPON or ACTIVITY.
      - `seller_funded_shipping_promotions` OrderPricePromotionOut[]
        - `activity_id` string, required: Promotion activity or coupon id.
        - `discount_amount` string, nullable: Decimal string, as TikTok sends it.
        - `discount_type` string, nullable: COUPON or ACTIVITY.

## Other responses

- `400`: Multi-shop key or an order id that is not 1-32 digits.
- `403`: The shop's TikTok grant lacks `seller.order.info` (`SCOPE_NOT_GRANTED`).
- `404`: No such order on this shop.
- `422`: Validation Error
- `429`: TikTok is rate limiting this shop (`UPSTREAM_RATE_LIMITED`, with `Retry-After`).

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-25** `84094c04c9fd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/orders/:order_id/price_detail/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)