Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Merchant secret key, or an authorized Platform secret key with delegation where documented.

Headers

Ionic-Account
string

Merchant ID when an authorized Platform acts for a connected Merchant.

Pattern: ^mer_[0-9A-Za-z]{14}$

Path Parameters

id
string
required

Ionic Terminal batch ID.

Pattern: ^tmb_[0-9A-Za-z]{24}$

Response

The Terminal batch.

id
string
required

Unique identifier for the batch (tmb_…).

Pattern: ^tmb_[0-9A-Za-z]{24}$
object
enum<string>
required
Available options:
terminal_batch
merchant_id
string
required

ID of the account that owns the batch (mer_…).

Pattern: ^mer_[0-9A-Za-z]{14}$
livemode
boolean
required
settlement_profile_id
string
required

ID of the settlement profile this batch belongs to (stlp_…).

Pattern: ^stlp_[0-9A-Za-z]{24}$
terminal_ids
string[]
required

IDs of the terminals whose transactions are in this batch (tmr_…).

Pattern: ^tmr_[0-9A-Za-z]{14}$
status
enum<string>
required

Whether the batch is open, closing, or closed.

Available options:
open,
closing,
closed
reconciliation_status
enum<string>
required

Whether the batch's transactions have been matched to your charges and refunds. reconciled means every transaction is matched.

Available options:
not_started,
pending,
reconciled,
incomplete,
needs_attention
currency
string
required

Three-letter ISO currency code, in lowercase.

Pattern: ^[a-z]{3}$
transaction_count
integer<int64>
required

Number of transactions in the batch.

matched_item_count
integer<int64>
required

Number of batch transactions matched to a charge or refund. Stays 0 until the batch is closed and matched.

unmatched_item_count
integer<int64>
required

Number of batch transactions not matched to a charge or refund. Stays 0 until the batch is closed and matched.

totals
object
required

Money totals for the batch, in the smallest currency unit.

data_as_of
integer<int64>
required

Unix epoch seconds represented by this snapshot.

stale_after
integer<int64>
required

Unix epoch seconds after which this snapshot is stale.

is_stale
boolean
required

Whether the batch snapshot is past stale_after, so its totals may be out of date.

opened_at
integer<int64>
required

Unix epoch seconds when the batch opened.

closed_at
integer<int64> | null
required

Unix epoch seconds when the batch closed. Null until it closes.

reconciled_at
integer<int64> | null
required

Unix epoch seconds when every transaction was matched. Null until the batch is reconciled.

created_at
integer<int64>
required

Unix epoch seconds when the batch was created.

updated_at
integer<int64>
required

Unix epoch seconds when the batch was last updated.