TikTok Shop

Affiliate orders in a window checked against what TikTok settled

GET/api/public/v1/tik_tok_shop/finance/reconciliation
ConnectorAnswers empty results in the documented shape until the brand switches on this connection.

Operation id getTikTokShopReconciliation

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/tik_tok_shop/finance/reconciliation?start_date=2026-11-01&end_date=2026-11-01" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
start_datequerystring (date)required
end_datequerystring (date)required
limitqueryinteger Default 25
cursorquerystring
tolerancequerystring Default 0.01
organization_idqueryinteger

Responses

200Success

FieldTypeNotes
basisstring, nullable
currencystring, nullable
nextCursor, nullable
ordersarray of object, nullable
orders[].[].error, nullable
orders[].[].mismatchobject, nullable
orders[].[].mismatch.againststring, nullable
orders[].[].mismatch.deltastring, nullable
orders[].[].mismatch.fieldstring, nullable
orders[].[].mismatch.settledstring, nullable
orders[].[].mismatch.storedstring, nullable
orders[].[].orderCreateTimestring, nullable
orders[].[].orderIdstring, nullable
orders[].[].settledobject, nullable
orders[].[].settled.affiliateCommissionstring, nullable
orders[].[].settled.currencystring, nullable
orders[].[].settled.feeAndTaxAmountstring, nullable
orders[].[].settled.revenueAmountstring, nullable
orders[].[].settled.settlementAmountstring, nullable
orders[].[].settled.shippingCostAmountstring, nullable
orders[].[].settled.statementIdsarray of string, nullable
orders[].[].statusstring, nullable
orders[].[].storedobject, nullable
orders[].[].stored.actualCommissionstring, nullable
orders[].[].stored.currencystring, nullable
orders[].[].stored.estimatedCommissionstring, nullable
orders[].[].stored.fullyReturnedboolean, nullable
orders[].[].stored.gmvstring, nullable
orders[].[].stored.settlementStatusesarray of string, nullable
orders[].[].stored.skuLinesnumber, nullable
orders[].[].stored.unitsstring, nullable
orders[].[].unsettled, nullable
summaryobject, nullable
summary.errorsnumber, nullable
summary.mismatchesnumber, nullable
summary.notFoundnumber, nullable
summary.ordersnumber, nullable
summary.partiallySettlednumber, nullable
summary.settledobject, nullable
summary.settled.countnumber, nullable
summary.settled.settlementAmountstring, nullable
summary.uncheckednumber, nullable
summary.unknownnumber, nullable
summary.unsettledobject, nullable
summary.unsettled.countnumber, nullable
summary.unsettled.estSettlementAmountstring, nullable
sweptThroughstring, nullable
tolerancestring, nullable
truncatedboolean, nullable
truncatedReasonsarray of object
windowobject, nullable
window.endDatestring, nullable
window.startDatestring, nullable

Example

{
  "basis": "string",
  "currency": "usd",
  "nextCursor": "string",
  "orders": [
    {
      "error": "string",
      "mismatch": {
        "against": "string",
        "delta": "string",
        "field": "string",
        "settled": "string",
        "stored": "string"
      },
      "orderCreateTime": "string",
      "orderId": "string",
      "settled": {
        "affiliateCommission": "string",
        "currency": "usd",
        "feeAndTaxAmount": "string",
        "revenueAmount": "string",
        "settlementAmount": "string",
        "shippingCostAmount": "string",
        "statementIds": [
          "string"
        ]
      },
      "status": "string",
      "stored": {
        "actualCommission": "string",
        "currency": "usd",
        "estimatedCommission": "string",
        "fullyReturned": true,
        "gmv": "string",
        "settlementStatuses": [
          "string"
        ],
        "skuLines": 125.5,
        "units": "string"
      },
      "unsettled": "string"
    }
  ],
  "summary": {
    "errors": 125.5,
    "mismatches": 125.5,
    "notFound": 125.5,
    "orders": 125.5,
    "partiallySettled": 125.5,
    "settled": {
      "count": 125.5,
      "settlementAmount": "string"
    },
    "unchecked": 125.5,
    "unknown": 125.5,
    "unsettled": {
      "count": 125.5,
      "estSettlementAmount": "string"
    }
  },
  "sweptThrough": "string",
  "tolerance": "string",
  "truncated": true,
  "truncatedReasons": [
    "string"
  ],
  "window": {
    "endDate": "string",
    "startDate": "string"
  }
}

Errors: 400401403404422429502with an error and usually a message. See errors.

Example values are made up from each field's type and name.