Get Balance Transaction

GET /api/v1/balance_transactions/:id

Overview

Retrieves the balance transaction details for a specific transaction using its unique identifier.

Authorization

Header: Authorization: Bearer $PAYBYTOKEN_SECRET_KEY

Request Details

Request

curl https://api-prod.paybytoken.io/api/v1/balance_transactions/btx_pdMf5r3updqUKflE \
  -X GET \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY"

Request Parameters

Parameter	Type	Description
`id`	string	Unique identifier of the balance transaction (e.g., `btx_pdMf5r3updqUKflE`).

Response Details

Response

The response returns a BalanceTransaction object containing the transaction details. See Balance Transactions Overview for the full object definition.

Example Response

{
  "id": "btx_pdMf5r3updqUKflE",
  "account_id": "p226968785",
  "balance_id": "bal_ofK07A66lSdtbXIa",
  "amount": "5.0",
  "currency": "USDC",
  "chain": "base",
  "description": null,
  "fee": "0.025",
  "total": "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",
  "remark": null,
  "created_at": "2025-09-25T10:35:10.000Z",
  "updated_at": "2025-09-25T18:35:10.000Z"
}