The Core Transaction Object - Lead | API Docs

A core transaction is a single ledger entry that changed a core balance. Lead creates them. You read them with GET /v2/core_transactions and GET /v2/core_transactions/{id}.

{
  "id": "core_transaction_3JpKd8vN2wQxT5mRz7bYaL4cE9f",
  "core_balance_id": "core_balance_2xYw9Lp4Kq8RvT3mZ6nBcD1eF7g",
  "type": "ach",
  "description": "Incoming ach_3JpCw2kQ9rTb7yLm4XnVdE8oF1g NORTHWIND LLC PAYROLL",
  "amount": 248250,
  "currency_code": "USD",
  "created_at": "2026-09-25T15:02:14Z",
  "updated_at": "2026-09-25T15:02:14Z"
}

Fields

Field	Type	Description
`id`	string	Unique identifier, prefixed `core_transaction_`.
`core_balance_id`	string	The core balance this entry affected.
`type`	enum	The rail or mechanism that created the entry. See The type enum.
`description`	string, max 120	Human-readable memo. Useful for eyeballing, not for matching. Use `type` and the core transaction ID fields on the payment object to match.
`amount`	integer	Signed, minor units. Positive is a credit to the balance, negative is a debit.
`currency_code`	string	ISO 4217.
`created_at`	timestamp	When the entry posted and affected the balance. UTC.
`updated_at`	timestamp	Usually equals `created_at`.

A core transaction has a single state, posted. It exists only once it has affected the balance. There is no pending state and no status field. Corrections are new, offsetting entries with their own IDs.

The type enum

The list of type values is being finalized and will be published here before the beta opens.

List and retrieve

GET /v2/core_transactions lists entries for one balance. Filters:

core_balance_id (required). The balance to list.
type. One of the enum values. An unknown value returns 400 parameters_invalid.
created_at[after], created_at[on_or_after], created_at[before], created_at[on_or_before]. Standard time window.
limit, starting_after, ending_before. Cursor pagination. Cursors are core transaction IDs.

GET /v2/core_transactions/{id} returns one entry. 404 if not found or not yours. Core Transaction Overview · The Core Balance Object · The ACH Object · The Wire Object · Daily Activity report