Get an API account statement
Returns the entries of one API account between two times, oldest first. Each entry is one credit or one debit of the account balance. The statement also gives the balance at the start and at the end of the window.
Path parameters
The API account's id, from List API accounts.
Query parameters
The start of the window. Entries at or after this time are included. An ISO
8601 date or date and time, for example 2026-11-01T00:00:00Z. A time
without an offset is read as UTC. Must be at least one minute in the past.
The end of the window. An entry made exactly at to is not included. A
time later than one minute before your request is changed to one minute
before your request. The window can be 31 days or shorter.
The page of entries to fetch. Minimum 1, maximum 10000.
Entries per page. Minimum 1, maximum 100.
Request
curl -G "https://api-prod.useknit.io/api/v1/business-api-services-wallets/c7ddb254-5da1-4136-b19e-733a00a31c70/statement" \
-H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
-H "Accept: application/json" \
--data-urlencode "from=2026-11-01T00:00:00Z" \
--data-urlencode "to=2026-12-01T00:00:00Z" \
--data-urlencode "perPage=100"Response
{
"statusCode": 200,
"message": "Statement retrieved successfully",
"data": {
"accountId": "c7ddb254-5da1-4136-b19e-733a00a31c70",
"token": "USDT",
"from": "2026-11-01T00:00:00.000000Z",
"to": "2026-11-21T11:59:00.000000Z",
"asOf": "2026-11-21T12:00:00.000000Z",
"openingBalance": "100",
"closingBalance": "134.5",
"totalCredits": "70",
"totalDebits": "35.5",
"netChange": "34.5",
"entryCount": 2,
"entries": [
{
"id": "01a1fb82-b93a-7086-9a68-5d7a33965161",
"type": "CREDIT",
"category": "WALLETS COLLECTION",
"amount": "70",
"amountNet": "71",
"fee": "1",
"balanceAfter": "170",
"network": "TRON_MAINNET",
"sourceType": "WALLET_TRANSACTION",
"sourceId": "01a1fb82-b8f2-73a0-8b51-0f1e5a8a9c11",
"reversalOfId": null,
"description": null,
"createdAt": "2026-11-10T08:00:00.000000Z"
},
{
"id": "01a1fe1c-64ef-7326-9537-6ef0bf202770",
"type": "DEBIT",
"category": "PAYOUT",
"amount": "35.5",
"amountNet": "35",
"fee": "0.5",
"balanceAfter": "134.5",
"network": "TRON_MAINNET",
"sourceType": "PAYOUT",
"sourceId": "01a1fe1c-64e3-71f3-8a9a-37985087d7a1",
"reversalOfId": null,
"description": null,
"createdAt": "2026-11-12T09:00:00.000000Z"
}
]
},
"pagination": {
"totalItems": 2,
"page": 1,
"perPage": 100,
"currentPage": 1,
"lastPage": 1
},
"success": true
}Statement fields
The start of the window that the statement used.
The end of the window that the statement used, to the second. It is one
minute before asOf when you sent no to, or a to later than that,
without the fraction of a second. Knit waits one
minute because an entry can take a few seconds to be recorded after its
createdAt. Start your next statement at this to.
The time Knit made the statement.
The account balance at from.
The account balance at to. It is always openingBalance plus
totalCredits minus totalDebits.
The sum of amount of all CREDIT entries in the window, on all pages.
The sum of amount of all DEBIT entries in the window, on all pages.
The number of entries in the window, on all pages.
One page of entries, oldest first.
The balance and total fields are the same on every page. Only entries
changes from page to page.
Entry fields
The ID of the entry. A deposit in List deposits
shows this ID as ledgerEntryId.
CREDIT adds amount to the balance. DEBIT takes amount from the
balance.
What the entry is for, for example PAYOUT, WALLETS COLLECTION (a deposit
to an API wallet) or COLLECTION.
The change to the balance. For a payout it includes the fee.
For a payout, the amount the recipient got. For a deposit or a collection, the amount that arrived before the fee.
The fee in this entry.
The account balance after this entry.
What made the entry: PAYOUT, WALLET_TRANSACTION (a deposit),
COLLECTION, SUBSCRIPTION, TRANSACTION (a transfer from or to your
business wallet) or BRIDGE (the fee of a
bridge). null when Knit did not record a
source.
The ID of that payout, deposit, collection, transfer or bridge.
For a refund, the id of the entry it gives back. A refunded payout has a
DEBIT entry and a CREDIT entry with this field set to the debit's id.
Knit records entry times to the second. When several entries have the same
createdAt, the order between them can differ from the order in which they
happened. openingBalance, closingBalance and the totals do not change
because of this.
Monthly statements
The window can be 31 days or shorter, so one call can cover one calendar month.
To read more than one month, request one month at a time. The closingBalance
of one month is the openingBalance of the next month when the next from is
the same time as the last to.
Errors
| Status | Cause |
|---|---|
400 | A query parameter is not valid: from is missing or less than one minute in the past, to is before from, the window is longer than 31 days, or perPage is above 100. The body carries an errors entry for the parameter |
401 | Missing or invalid token, IP not allow-listed, or missing payout-wallets:read |
404 | No API account with that ID belongs to your business |