Get Transactions

requires auth

Transactions

Endpoint to retrieve account transactions information. Used to obtain a list of transactions within a date range.

Response will show all types of transactions in the account.

GET /api/v1/accounting/ledger/{accountId}

Path Parameters:

Path	Type	Description
accountId*	string	your account ID

Query	Type	Description
max*	string	maximum number of transactions in the response
transactionId	string	ID of transaction
asset	string	the asset of transaction
type	string	transaction type ("invalid" "deposit" "withdrawal" "transferSent" "transferReceived" "trade" "manual" "order" "initialBalances")
startAtOrdering	integer <int64>	the order of the transaction in which to start query. ie.: '1081'. Please note that the order increment value is a global value to 1Konto and not specific to your integration. As such, the value will increment by at least 1.
startTimeUtc	string <date-time>	start of period for query
endTimeUtc	string <date-time>	end of period for query
format	string

Example

GET /api/v1/accounting/ledger/test123?max=5

// Successful Response body
[
    {
        "ordering": 81321,
        "accountId": "test123",
        "transactionId": "abcd01234abcd01234",
        "asset": "BTC",
        "amount": 76.0,
        "eventType": "deposit",
        "eventTime": "2023-05-12T21:38:21.6200000Z"
    },
    {
        "ordering": 81325,
        "accountId": "test123",
        "transactionId": "acd013abcd01",
        "asset": "USD",
        "amount": 150.0,
        "eventType": "transferReceived",
        "eventTime": "2023-05-12T21:38:26.7290000Z"
    },
    {
        "ordering": 81327,
        "accountId": "test123",
        "transactionId": "abcd0abcd02",
        "asset": "BTC",
        "amount": 0.00000025,
        "eventType": "manual",
        "eventTime": "2023-05-12T21:38:31.8360000Z"
    },
    {
        "ordering": 81329,
        "accountId": "test123",
        "transactionId": "ad4abcd023",
        "asset": "BTC",
        "amount": 1.0,
        "eventType": "trade",
        "subEventType": "source",
        "eventTime": "2023-05-12T21:38:36.9430000Z"
    },
    {
     "ordering": 81329,
        "accountId": "test123",
        "transactionId": "c3abcabcdbcdd02",
        "asset": "ETH",
        "amount": 1.0,
        "eventType": "trade",
        "subEventType": "destination",
        "eventTime": "2023-05-12T21:38:36.9430000Z"
    }
]