List Balance Transactions

GET /balance-transactions

Overview

Retrieves a paginated list of balance transactions with optional filtering by account, balance, currency, chain, type, or resource.

Authorization

• Header: Authorization: Bearer sk_test_907...de66

Request Details

Request

cURL

curl "https://api-prod.paybytoken.io/balance-transactions?account_id=acct_1&limit=10" \
  -X GET \
  -H "Authorization: Bearer sk_test_907...de66"

Request Parameters

Parameter	Type	Description
offset	number	Offset for pagination (default 0).
limit	number	Number of items per page (default 10, max 100).

Response Details

Response

The response returns a paginated list of BalanceTransaction objects.

Attributes

Attribute	Type	Description
total	integer	Total number of payment intents available.
data	array of objects	List of payment intent objects with their details.

Example Response

Success

{
  "total": 3,
  "data": [
    {
      "id": "btx_pdMf5r3updqUKflE",
      "account_id": "p226968785",
      "balance_id": "bal_ofK07A66lSdtbXIa",
      "amount": "5.0",
      "currency": "USDC",
      "chain": "base",
      "description": null,
      "fee": "0.025",
      "net": "4.975",
      "fee_details": [
        {
          "type": "service_fee",
          "currency": "USDC",
          "description": "Service fee for payment intent",
          "amount": "0.025"
        },
        {
          "type": "network_fee",
          "currency": "USDC",
          "description": "Network fee for payment intent",
          "amount": "0.0"
        }
      ],
      "type": "credit",
      "resource_type": "payment_intent",
      "resource_id": "pay_pdICAC1vp3WkAKof4QkM",
      "created_at": "2025-09-25T10:35:10.000Z",
      "updated_at": "2025-09-25T18:35:10.000Z",
      "token": {
        "id": "tok_ofIiMC131ysXsbCj",
        "currency": "USDC",
        "chain": "base",
        "decimals": 6,
        "name": "USD Coin",
        "chain_id": 84532,
        "chain_name": "Base",
        "currency_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/usdc-logo.png",
        "chain_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/base-logo.png",
        "chain_explorer_url": "https://sepolia.basescan.org",
        "contract_address": "0xBd02F04420F7bA751d6240f053E2decfb6c90821"
      }
    },
    {
      "id": "btx_pe0g3021LAI7aCei",
      "account_id": "p226968785",
      "balance_id": "bal_pdiDvNkBmV9wvjA6",
      "amount": "5.0",
      "currency": "USDC",
      "chain": "bnb_chain",
      "description": null,
      "fee": "0.025",
      "net": "4.975",
      "fee_details": [
        {
          "type": "service_fee",
          "currency": "USDC",
          "description": "Service fee for payment intent",
          "amount": "0.025"
        },
        {
          "type": "network_fee",
          "currency": "USDC",
          "description": "Network fee for payment intent",
          "amount": "0.0"
        }
      ],
      "type": "credit",
      "resource_type": "payment_intent",
      "resource_id": "pay_pdVpMS5dyYQk5ED06a4W",
      "created_at": "2025-09-25T11:30:51.000Z",
      "updated_at": "2025-09-25T19:30:51.000Z",
      "token": {
        "id": "tok_pdcvY8c0GjanZazA",
        "currency": "USDC",
        "chain": "bnb_chain",
        "decimals": 18,
        "name": "USD Coin",
        "chain_id": 97,
        "chain_name": "BNB Chain",
        "currency_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/usdc-logo.png",
        "chain_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/bnb-logo.png",
        "chain_explorer_url": "https://testnet.bscscan.com",
        "contract_address": "0x46E59191cfE8bF9Bdb1417Bdf3e72179fCA0F338"
      }
    }
  ]
}