Get Statements

GET

/finance/202309/statements

Retrieves the statements generated for a shop and the key statement information based on a specified date range or their payment status. Use this API to get an overview of your daily statements over a range of time, or to find out which statements have been paid or not. For the detailed transactions, refer to Get Statement Transactions or Get Order Statement Transactions. Applicable for all regions’ sellers. Only data after 2023-07-01 is available.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

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

statement_time_lt

integer format: int64

Filter statements to show only those generated before the specified date and time. Unix timestamp in seconds. Refer to the notes in statement_time_ge for more usage information.

payment_status

string

Allowed values: PAID FAILED PROCESSING

Filter statements based on the payment status. Possible values:

• PAID: Payment has been transferred to the seller.
• FAILED: Payment transfer failed.
• PROCESSING: Payment is currently being processed. Default: All statuses are returned.

page_size

integer format: int64

>= 1 <= 100

The number of results to be returned per page. Default: 20 Valid range: [1-100]

page_token

string

An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page.

sort_field

required

string

The returned results will be sorted by the specified field. Only supports statement_time.

sort_order

string

Allowed values: ASC DESC

The sort order for the sort_field parameter. Default: ASC Possible values:

• ASC: Ascending order
• DESC: Descending order

statement_time_ge

integer format: int64

Filter statements to show only those generated on or after the specified date and time. Unix timestamp in seconds.

Note: statement_time_ge and statement_time_lt together define a half-open statement-generation time range: statement_time_ge is inclusive and statement_time_lt is exclusive.

• If statement_time_ge is provided but statement_time_lt is omitted, statement_time_lt defaults to the current time.
• If statement_time_lt is provided but statement_time_ge is omitted, statement_time_ge defaults to the earliest shop time.

Example: Statements are generated daily at 00:00 UTC and cover transactions from the previous day. To query the statement generated for transactions on April 28, 2026, use the exact statement-generation interval [2026-04-29T00:00:00Z, 2026-04-30T00:00:00Z):

• Set statement_time_ge to 1777420800 (inclusive).
• Set statement_time_lt to 1777507200 (exclusive).

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

next_page_token

An opaque token used to retrieve the next page of a paginated result set. If this value is non-empty, provide it in the page_token parameter of the next request. An empty next_page_token means there are no more results.

string

statements

The list of statements that meet the query conditions.

Array<object>

object

id

The statement ID.

string

statement_time

The time when the statement was generated, expressed as a Unix timestamp in seconds. Statements are generated daily at 00:00 UTC and include all transactions from the previous day.

integer format: int64

settlement_amount

The settlement amount.

string

currency

The currency code in ISO 4217 format.

string

revenue_amount

The final revenue amount at the time of order settlement. Applicable for all regions except UK and US.

string

fee_amount

The fees charged by TikTok Shop at the time of order settlement. An order is deemed settled a certain number of days after delivery (varies by region) if no returns or refunds are pending.

Note: Shipping-related costs are excluded, except for local sellers in the SEA region, where they are included.

string

adjustment_amount

The adjustment amount. For more details about the reason for adjustment, refer to the Get Statement Transactions API.

string

payment_status

The payment status, indicating whether payment has been transferred to the seller’s bank account or settled to the seller’s account. Possible values:

• PAID: Payment has been transferred to the seller.
• FAILED: Payment transfer failed.
• PROCESSING: Payment is currently being processed.
• SETTLED: Funds have been settled to the seller’s account.

string

Allowed values: PAID FAILED PROCESSING SETTLED

payment_id

The payment ID.

string

net_sales_amount

The final revenue amount after seller discounts are deducted. Applicable only for local sellers outside the SEA region.

string

shipping_cost_amount

The shipping fees. Applicable only for local sellers outside the SEA region.

string

payment_time

The Unix payment timestamp

integer format: int64

Example

{
  "code": 0,
  "data": {
    "next_page_token": "6AsPQsUMvH3RkchNUPPh22NROHkE0D8pmq/N5M1kHYcZmtRyv9aVrNv65W7Q6tFA+7D1ud64MPNz5OaT",
    "statements": [
      {
        "id": "7238804564097517339",
        "statement_time": 1685548800,
        "settlement_amount": "100",
        "currency": "GBP",
        "revenue_amount": "200",
        "fee_amount": "-30",
        "adjustment_amount": "-70",
        "payment_status": "PAID",
        "payment_id": "3459275187040258849",
        "net_sales_amount": "-70",
        "shipping_cost_amount": "-70",
        "payment_time": 1685548800
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}