Statement transactions

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statementId": "7440000000000000001",
  "createTime": 1758844800,
  "status": "SETTLED",
  "currency": "USD",
  "payableAmount": 1234.56,
  "totalReserveAmount": 0,
  "totalSettlementAmount": 1234.56,
  "totalSettlementBreakdown": {
    "totalRevenueAmount": 1580,
    "totalShippingCostAmount": -35,
    "totalFeeTaxAmount": -310.44,
    "totalAdjustmentAmount": 0
  },
  "totalCount": 48,
  "transactions": [
    {
      "id": "7441000000000000001",
      "type": "ORDER",
      "orderId": "576000000000000001",
      "orderCreateTime": 1757096530,
      "adjustmentId": null,
      "adjustmentOrderId": null,
      "adjustmentAmount": null,
      "settlementAmount": 17.49,
      "revenueAmount": 24.99,
      "revenueBreakdown": {
        "subtotalBeforeDiscountAmount": 24.99,
        "sellerDiscountAmount": 0
      },
      "shippingCostAmount": 0,
      "shippingCostBreakdown": {
        "actualShippingFeeAmount": 0
      },
      "feeTaxAmount": -7.5,
      "feeTaxBreakdown": {
        "fee": {
          "affiliateCommissionAmount": -3.75,
          "referralFeeAmount": -2,
          "transactionFeeAmount": -1.75
        },
        "tax": {}
      },
      "supplementaryComponent": {},
      "reserveId": null,
      "reserveAmount": null,
      "associatedOrderId": null,
      "reserveStatus": null,
      "estimatedReleaseTime": null
    }
  ],
  "nextPageToken": "b2Zmc2V0PTIw"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Statement transactions

Lists every transaction settled in one statement: orders (type ORDER), adjustments (with adjustmentId, adjustmentOrderId and adjustmentAmount) and reserves (RESERVE, with reserveAmount, reserveStatus COLLECTED or RELEASED, and estimatedReleaseTime). Take statementId from Settlement statements.

The response carries payableAmount (settlement plus reserve), totalSettlementAmount, totalReserveAmount, totalSettlementBreakdown and totalCount. Order rows include revenue, shipping, fee and tax amounts with breakdown maps; affiliate commission is feeTaxBreakdown.fee.affiliateCommissionAmount. Rows have no currency of their own and use the statement’s currency. US cross-border data starts 2025-04-30. Rows are sorted by order create time, newest first unless you set sort_order=ASC. page_size is 1 to 100; pass nextPageToken back as page_token. Read live from TikTok.

GET

tik_tok_shop

finance

statements

{statementId}

transactions

Statement transactions

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/finance/statements/{statementId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "statementId": "7440000000000000001",
  "createTime": 1758844800,
  "status": "SETTLED",
  "currency": "USD",
  "payableAmount": 1234.56,
  "totalReserveAmount": 0,
  "totalSettlementAmount": 1234.56,
  "totalSettlementBreakdown": {
    "totalRevenueAmount": 1580,
    "totalShippingCostAmount": -35,
    "totalFeeTaxAmount": -310.44,
    "totalAdjustmentAmount": 0
  },
  "totalCount": 48,
  "transactions": [
    {
      "id": "7441000000000000001",
      "type": "ORDER",
      "orderId": "576000000000000001",
      "orderCreateTime": 1757096530,
      "adjustmentId": null,
      "adjustmentOrderId": null,
      "adjustmentAmount": null,
      "settlementAmount": 17.49,
      "revenueAmount": 24.99,
      "revenueBreakdown": {
        "subtotalBeforeDiscountAmount": 24.99,
        "sellerDiscountAmount": 0
      },
      "shippingCostAmount": 0,
      "shippingCostBreakdown": {
        "actualShippingFeeAmount": 0
      },
      "feeTaxAmount": -7.5,
      "feeTaxBreakdown": {
        "fee": {
          "affiliateCommissionAmount": -3.75,
          "referralFeeAmount": -2,
          "transactionFeeAmount": -1.75
        },
        "tax": {}
      },
      "supplementaryComponent": {},
      "reserveId": null,
      "reserveAmount": null,
      "associatedOrderId": null,
      "reserveStatus": null,
      "estimatedReleaseTime": null
    }
  ],
  "nextPageToken": "b2Zmc2V0PTIw"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

statementId

string

required

A statement id from /finance/statements.

Pattern: ^\d{1,32}$

Query Parameters

sort_order

enum<string>

default:DESC

DESC (newest first) unless set. TikTok's own default is ASC.

Available options:

ASC,

DESC

page_size

integer

Rows per page, 1 to 100. TikTok's default is 20.

Required range: 1 <= x <= 100

page_token

string

The nextPageToken from the previous page. Omit on the first page.

organization_id

integer

Use the TikTok Shop of this child brand (organization id) of your API key's organization

Response

{ statementId, createTime, status, currency, payableAmount, totalReserveAmount, totalSettlementAmount, totalSettlementBreakdown, totalCount, transactions: [...], nextPageToken }

Overview

Conversions

Tracking events

Campaign affiliates

Organization

Applications

Stats

TikTok Shop

Statement transactions

Authorizations

Path Parameters

Query Parameters

Response