Resource commands

Transactions

Use the Blnk CLI to list, create, and update transactions on your Core instance.

Use the transactions command to list transfers, inspect a single post, create transactions interactively, and commit, void, or refund inflight work. Reach for this command when you are debugging money movement or testing a flow on Core.

Command	Alias	Description
list	l	Browse transfers with filters; add `--id` for one transaction
create	c	Post a transfer via interactive prompts
update	u	Commit, void, or refund an existing transaction

`list`

Monitor money movement in a paginated table with amount, currency, status, and related IDs. Filter by --status, --currency, or --balance-id to audit queued work, applied posts, or activity on one account.

blnk transactions list [options]

Options

Option	Type	Default	Description
`--{field}`	string	-	Filter by any indexed field (for example `--status APPLIED`, `--currency "USD,EUR"`).
`-p, --page`	integer	`1`	Page number.
`--per-page`	integer	`10`	Results per page.
`-h, --help`	boolean	-	Show help for this command.

Usage

List all transactions

Run the command to view a paginated table of transactions:

blnk transactions list

Filter and paginate:

blnk transactions list --page 3 --per-page 25
blnk transactions list --status APPLIED --currency "USD,EUR"
blnk transactions list --balance-id bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f --status APPLIED

┌────────────────   ─────────   ────────   ────────   ────────   ────────────────   ────────────────   ────────────────   ───────────────────────────┐
│ Transaction ID   │ Parent ID │ Amount   │ Currency │ Status   │ Source           │ Destination      │ Reference        │ Created At                  │
| ---------------- | --------- | -------- | -------- | -------- | ---------------- | ---------------- | ---------------- | --------------------------- |
│ txn_fa19841f...  │ N/A       │     12.4 │ USDC     │ APPLIED  │ bln_c4984d90...  │ bln_d98d6524...  │ ref_4809d836...  │ 2026-06-03T12:35:29.822965Z │
│ txn_ac1d86a2...  │ N/A       │     12.4 │ USDC     │ INFLIGHT │ bln_c4984d90...  │ bln_d98d6524...  │ ref_94175e3e...  │ 2026-06-03T12:34:52.925262Z │
│ txn_ff016b8b...  │ N/A       │     12.4 │ USDC     │ QUEUED   │ bln_c4984d90...  │ bln_d98d6524...  │ ref_94175e3e...  │ 2026-06-03T12:34:52.925262Z │
└────────────────   ─────────   ────────   ────────   ────────   ────────────────   ────────────────   ────────────────   ───────────────────────────┘
98 results found
Page 1/33

Status values may appear colorized in your terminal.

`list --id`

Inspect one transaction end to end: source, destination, reference, status, and metadata. Pass --json when you need precision, inflight flags, or parent/child links exactly as Core returns them.

blnk transactions list --id <transaction-id> [options]

Options

Option	Type	Required	Description
`--id`	string	Yes	Transaction ID to fetch (for example `txn_fa19841f-faa5-4838-9295-b7278a4ff71d`).
`--json`	boolean	No	Print the full API object as JSON instead of a formatted summary.
`-h, --help`	boolean	No	Show help for this command.

Usage

Get one transaction

Run the command with a transaction ID:

blnk transactions list --id txn_fa19841f-faa5-4838-9295-b7278a4ff71d

Transaction details:
  amount: 12.4 USDC
  transaction_id: txn_fa19841f-faa5-4838-9295-b7278a4ff71d
  source: bln_c4984d90-9414-4450-9d94-120f7b2f6b29
  destination: bln_d98d6524-29d8-472e-99cd-8a89e9e01243
  reference: ref_4809d836-0e6a-4975-971a-fde118672faa
  status: APPLIED
  created_at: 2026-06-03T12:35:29Z
  meta_data: {"QUEUED_PARENT_TRANSACTION":"txn_ff016b8b-a5c5-4394-90c6-774be65b74bc","allow_overdraft":true}

{
  "transaction_id": "txn_fa19841f-faa5-4838-9295-b7278a4ff71d",
  "amount": 12.4,
  "currency": "USDC",
  "precision": 10000,
  "source": "bln_c4984d90-9414-4450-9d94-120f7b2f6b29",
  "destination": "bln_d98d6524-29d8-472e-99cd-8a89e9e01243",
  "reference": "ref_4809d836-0e6a-4975-971a-fde118672faa",
  "description": "Test",
  "status": "APPLIED",
  "inflight": true,
  "created_at": "2026-06-03T12:35:29.822965Z",
  "meta_data": {}
}

`create`

Post a transfer between balances (or indicators) through prompts for amount, precision, parties, reference, and inflight options. Handy for quick manual tests; multi-leg or high-volume flows should go through your application integration instead.

blnk transactions create [options]

Arguments

The CLI prompts for these values. They are not passed on the command line.

Argument	Type	Required	Description
`amount`	string	Yes	Transaction amount. Prompt: `amount >`
`precision`	integer	Yes	Amount precision (for example `100` for cents). Prompt: `precision >`
`currency`	string	Yes	Currency code. Prompt: `currency >`
`source`	string	Yes	Source balance ID or indicator. Prompt: `source >`
`destination`	string	Yes	Destination balance ID or indicator. Prompt: `destination >`
`reference`	string	Yes	Unique reference for the transaction. Prompt: `reference >`
`description`	string	Yes	Short description. Prompt: `description >`
`allow_overdraft`	boolean	No	Whether overdraft is allowed. Prompt: `allow overdraft >`
`inflight`	boolean	No	Whether the transaction is inflight. Prompt: `inflight >`
`meta_data`	object	No	Optional metadata as JSON. Prompt: `metadata (json) >`. Press Enter to skip.

Options

Option	Type	Description
`--json`	boolean	After a successful create, print the full API response as JSON.
`-h, --help`	boolean	Show help for this command.

Usage

Create new transaction

Run the command:

blnk transactions create

The CLI prompts for each argument:

amount >
precision >
currency >
source >
destination >
reference >
description >
allow overdraft >
inflight >
metadata (json) >

Press Enter at the metadata prompt to leave it empty.

Read the created transaction

Transaction created:
  amount: 100 USD
  transaction_id: txn_6164573b-6cc8-45a4-ad2e-7b4ba6a60f7d
  source: bln_source
  destination: bln_destination
  reference: ref_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94
  status: APPLIED
  created_at: 2026-05-23T17:07:49Z
  meta_data: {}

{
  "transaction_id": "txn_6164573b-6cc8-45a4-ad2e-7b4ba6a60f7d",
  "amount": 100,
  "currency": "USD",
  "source": "bln_source",
  "destination": "bln_destination",
  "reference": "ref_f482a1b3-6c2d-4e89-a17b-3d5e8f2a1c94",
  "status": "APPLIED",
  "created_at": "2026-05-23T17:07:49.876192Z",
  "meta_data": {}
}

`update`

Move an existing transaction through its lifecycle: commit inflight funds, void before settlement, or refund after apply. Supply the transaction ID and exactly one of --commit, --void, or --refund.

blnk transactions update [options] <transaction-id>

Arguments

Argument	Type	Required	Description
`transaction-id`	string	Yes	Transaction ID to update (for example `txn_6164573b-6cc8-45a4-ad2e-7b4ba6a60f7d`).

Options

Option	Type	Description
`--commit`	boolean	Fully commit an inflight transaction.
`--void`	boolean	Void an inflight transaction.
`--refund`	boolean	Refund a transaction.
`-h, --help`	boolean	Show help for this command.

Usage

Commit a transaction

Run the command with --commit and an inflight transaction ID:

blnk transactions update --commit txn_ac1d86a2-9332-4676-89fb-630ed967e610

Transaction committed:
  amount: 12.4 USDC
  transaction_id: txn_fa19841f-faa5-4838-9295-b7278a4ff71d
  source: bln_c4984d90-9414-4450-9d94-120f7b2f6b29
  destination: bln_d98d6524-29d8-472e-99cd-8a89e9e01243
  reference: ref_4809d836-0e6a-4975-971a-fde118672faa
  status: APPLIED
  created_at: 2026-06-03T12:35:29Z
  meta_data: {"QUEUED_PARENT_TRANSACTION":"txn_ff016b8b-a5c5-4394-90c6-774be65b74bc","allow_overdraft":true}

Void a transaction

Run the command with --void and an inflight transaction ID:

blnk transactions update --void txn_ff016b8b-a5c5-4394-90c6-774be65b74bc

Transaction voided:
  amount: 12.4 USDC
  transaction_id: txn_a1b2c3d4-e5f6-7890-abcd-ef1234567890
  source: bln_c4984d90-9414-4450-9d94-120f7b2f6b29
  destination: bln_d98d6524-29d8-472e-99cd-8a89e9e01243
  reference: ref_94175e3e-89ce-41a3-bcdc-83504836637a_q
  status: VOID
  created_at: 2026-06-03T12:36:01Z
  meta_data: {"QUEUED_PARENT_TRANSACTION":"txn_ff016b8b-a5c5-4394-90c6-774be65b74bc","allow_overdraft":true}

Refund a transaction

Run the command with --refund and an applied transaction ID:

blnk transactions update --refund txn_fa19841f-faa5-4838-9295-b7278a4ff71d

Transaction refunded:
  amount: 12.4 USDC
  transaction_id: txn_1877186d-6841-4b9e-88f5-3170de40f656
  source: bln_d98d6524-29d8-472e-99cd-8a89e9e01243
  destination: bln_c4984d90-9414-4450-9d94-120f7b2f6b29
  reference: ref_c6f94d08-ac0e-4923-8487-26f8202a708b
  status: QUEUED
  created_at: 2026-06-04T19:27:16Z
  meta_data: {"QUEUED_PARENT_TRANSACTION":"txn_1877186d-6841-4b9e-88f5-3170de40f656","allow_overdraft":true}