Transaction Status Filters

Filter by transaction status
DECLINED, EXPIRED, PENDING, RETURNED, REVERSED, SETTLED, VOIDED

Filter by transaction result
APPROVED, DECLINED

Transaction Details

Financial Account Token

• Filter by financial account token

Business Account Token

• Filter by business account token

Account Token

• Filter by account token

Transaction Category

Filter by transaction category
ACH, WIRE, BALANCE_OR_FUNDING, FEE, REWARD, ADJUSTMENT, DERECOGNITION, DISPUTE, CARD, EXTERNAL_ACH, EXTERNAL_CHECK, EXTERNAL_FEDNOW, EXTERNAL_RTP, EXTERNAL_TRANSFER, EXTERNAL_WIRE, MANAGEMENT_ADJUSTMENT, MANAGEMENT_DISPUTE, MANAGEMENT_FEE, MANAGEMENT_REWARD, MANAGEMENT_DISBURSEMENT, HOLD, PROGRAM_FUNDING

Date Filters

• begin: Date string in RFC 3339 format.
• ending_before: A cursor representing an item's token before which a page of results should end.
• end: Date string in RFC 3339 format.
• page_size: Page size for pagination.
• starting_after: A cursor representing an item's token after which a page of results should begin.

Response Structure

200 Successful response with unified transaction data

object
A response containing a list of transactions

• has_more: boolean (required)

  • Indicates if there are more transactions available for pagination

• data: array of objects (required)

  • List containing all transaction types in the ledger service:
  • status: string (required)
    • The status of the transaction
      PENDING, SETTLED, DECLINED, REVERSED, CANCELED, RETURNED
  • token: uuid (required)
    • Unique identifier for the transaction
  • created: date-time (required)
    • ISO 8601 timestamp of when the transaction was created
  • updated: date-time (required)
    • ISO 8601 timestamp of when the transaction was last updated
  • family: const (required)
    • INTERNAL
  • category: string (required)
    • Transaction category
  • result: string (required)
    • Transaction result
  • currency: string (required)
    • Currency of the transaction, represented in ISO 4217 format
  • settled_amount: integer (required)
    • Settled amount in cents
  • pending_amount: integer (required)
    • Pending amount in cents
  • events: array of objects (required)
    • List of financial events
  • descriptor: string (required)
    • Transaction descriptor
  • financial_account_token: uuid (required)
    • Financial account token associated with the transaction

Sample Transaction Response

{
  "has_more": true,
  "data": [
    {
      "status": "PENDING",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2026-07-18T00:25:34.410Z",
      "updated": "2026-07-18T00:25:34.410Z",
      "family": "INTERNAL",
      "category": "ACH",
      "result": "APPROVED",
      "currency": "USD",
      "settled_amount": 200,
      "pending_amount": 500,
      "events": [
        {
          "amount": 0,
          "created": "2026-07-18T00:25:34.410Z",
          "result": "APPROVED",
          "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "ACH_ORIGINATION_CANCELLED"
        }
      ],
      "descriptor": "Transaction Descriptor",
      "financial_account_token": "0cc87075-57cf-4607-8722-f42e2cb2c0cd"
    }
  ]
}

Error Responses

• 400 Bad request
• 401 Unauthorized
• 403 Forbidden
• 500 Internal server error

Updated 3 months ago