Transactions

TransactionsCopied!

PrerequisitesCopied!

To retrieve valid transactions for an account, you must first have a valid ‘Account Holder’ and a connected ‘Account.’ For information on connecting an account, follow our guide here.

After a connection of an account, you must first trigger an ‘Account Refresh’ to retrieve up-to-date balances and transactions for that Account. Initial connections do not retrieve the full set of balances and transactions and must be done through the account refresh endpoint. For more information, please refer to our Account Refresh guide. 

Get TransactionsCopied!

After refreshing an account, use the List Transactions endpoint to view all transactions for that account. Provide the account_id parameter with the relevant account's ID to retrieve its transactions. 

Request:

curl --request POST \
  --url https://api.hoseki.app/v1/connect/transactions?\

          account_id=acc_kwXJ1LzI31eux3hgeiPtc \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \

Response:

{
  "data": [
    {
      "id": "tx_wP1eaeMfhK1wykYEtCUWM",
      "created_at": 1726532607,
      "updated_at": 1726532607,
      "transacted_at": 1725572449,
      "account_id": "acc_kwXJ1Lzfy9eux3yepiPtc",
      "record_id": "rec_96auUShxcl34mgmtyPPds",
      "currency": "USDC",
      "amount": "3565",
      "description": null,
      "status": "posted",
      "posted_at": 1725572449,
      "void_at": null
    },
    {
      "id": "tx_eIQYhsWTgjiO19l0lN4IG",
      "created_at": 1726532607,
      "updated_at": 1726532607,
      "transacted_at": 1725383312,
      "account_id": "acc_kwXJhuzI29eux3yepiPtc",
      "record_id": "rec_220mZ1YhelA1Pb6BSAhwL",
      "currency": "BTC",
      "amount": "1732",
      "description": null,
      "status": "posted",
      "posted_at": 1725383312,
      "void_at": null
    }
  ],
  "has_more": false
}


Note: To access detailed information about a transaction, you can use our GET endpoints to retrieve the transaction, account, or associated record.