> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lead.bank/llms.txt
> Use this file to discover all available pages before exploring further.

# The Core Transaction Object

> Field-level reference for the Core Transaction object, the type enum with lookups, the single posted state, and list filters.

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}`.

```json theme={null}
{
  "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](#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

<Note>
  The list of `type` values is being finalized and will be published here before the beta opens.
</Note>

## 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.

## Related

[Core Transaction Overview](/products/core-transaction/overview) · [The Core Balance Object](/products/core-balance/core-balance-object) · [The ACH Object](/products/ach/ach-object) · [The Wire Object](/products/wire/wire-object) · [Daily Activity report](/file-reference/reports/daily-activity)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.