v1

latestOpenAPI 3.1.02026-07-241910582.8 KB

List Ledger Transactions

get/ledger_transactions

Query parameters

id[]string[]

If you have specific IDs to retrieve in bulk, you can pass them as query parameters delimited with id[]=, for example ?id[]=123&id[]=abc.

ledger_idstring

To query ledger transactions by their ledger_id, use this query parameter.

ledger_account_idstring

To query ledger transactions by the presence of a ledger account on either side of the transaction, use this query parameter.

metadatastring

For example, if you want to query for records with metadata key Type and value Loan, the query would be metadata%5BType%5D=Loan. This encodes the query parameters.

effective_atstring date

Use gt (>), gte (>=), lt (<), lte (<=), or eq (=) to filter by effective_at. For example, for all dates after Jan 1 2000, use effective_at%5Bgt%5D=2000-01-01T00:00:00.000.

posted_atstring date

Use gt (>), gte (>=), lt (<), lte (<=), or eq (=) to filter by the posted at timestamp. For example, for all times after Jan 1 2000 12:00 UTC, use posted_at%5Bgt%5D=2000-01-01T12:00:00Z.

updated_atstring date

Use gt (>), gte (>=), lt (<), lte (<=), or eq (=) to filter by the posted at timestamp. For example, for all times after Jan 1 2000 12:00 UTC, use updated_at%5Bgt%5D=2000-01-01T12:00:00Z.

created_atstring

Use "gt" (>), "gte" (>=), "'lt" (<), "lte" (<=), or "eq" (=) to filter by the created at timestamp. For example, for all times after Jan 1 2000 12:00 UTC, use created_at%5Bgt%5D=2000-01-01T12:00:00Z.

order_bystring

Order by created_ator effective_at in asc or desc order. For example, to order by effective_at asc, use order_by%5Beffective_at%5D=asc. Ordering by only one field at a time is supported.

statusstring

To query ledger transactions by status, use this query parameter. Can be pending, posted, or archived.

status[]string[]

To query ledger transactions by multiple statuses, use this query parameter delimited with status[]=. Can be pending, posted, or archived.

ledger_account_settlement_idstring

To retrieve the itemized Ledger Transactions of an associated settlement, use this query parameter.

reverses_ledger_transaction_idstring

To find reversal ledger transactions that reverses a ledger transaction, use this parameter.

archived_reasonstring

To query ledger transactions that were auto-archived; currently only 'balance_lock_failure' for transactions that violated balance constraints.

ledgerable_idstring

If the ledger transaction can be reconciled to another object in Modern Treasury, the ID of the ledgerable can be used to query the ledger transactions.

ledgerable_typestring

If the ledger transaction can be reconciled to another object in Modern Treasury, the type of the ledgerable can be used to query the ledger transactions.

after_cursorstring
per_pageinteger
ltinteger
lteinteger
eqinteger
gtinteger
gteinteger
not_eqinteger

Use gt (>), gte (>=), lt (<), lte (<=), eq (=), or not_eq (!=) to filter by the ledger transaction amount. Only supported for single currency transactions.

Response

200