Error
A valid request URL is required to generate request examples{
"object": "terminal_batch.refresh",
"terminal_id": "<string>",
"data": [
{
"id": "<string>",
"object": "terminal_batch",
"merchant_id": "<string>",
"livemode": true,
"settlement_profile_id": "<string>",
"terminal_ids": [
"<string>"
],
"status": "open",
"reconciliation_status": "not_started",
"currency": "<string>",
"transaction_count": 123,
"matched_item_count": 123,
"unmatched_item_count": 123,
"totals": {
"sales": 123,
"refunds": 123,
"voids": 123,
"tips": 123,
"fees": 123,
"tax": 123,
"net": 123
},
"data_as_of": 123,
"stale_after": 123,
"is_stale": true,
"opened_at": 123,
"closed_at": 123,
"reconciled_at": 123,
"created_at": 123,
"updated_at": 123
}
]
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Terminal batches
Refresh a Terminal's current batches
Refreshes Ionic’s current batch information for one Merchant-owned
Terminal and returns the observed open batches. This is a read-only
operation: it never clears, forces, or closes a batch. Platforms can
select an authorized connected Account with Ionic-Account.
POST
/
terminal_batches
/
refresh
Error
A valid request URL is required to generate request examples{
"object": "terminal_batch.refresh",
"terminal_id": "<string>",
"data": [
{
"id": "<string>",
"object": "terminal_batch",
"merchant_id": "<string>",
"livemode": true,
"settlement_profile_id": "<string>",
"terminal_ids": [
"<string>"
],
"status": "open",
"reconciliation_status": "not_started",
"currency": "<string>",
"transaction_count": 123,
"matched_item_count": 123,
"unmatched_item_count": 123,
"totals": {
"sales": 123,
"refunds": 123,
"voids": 123,
"tips": 123,
"fees": 123,
"tax": 123,
"net": 123
},
"data_as_of": 123,
"stale_after": 123,
"is_stale": true,
"opened_at": 123,
"closed_at": 123,
"reconciled_at": 123,
"created_at": 123,
"updated_at": 123
}
]
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Merchant secret key, or an authorized Platform secret key with delegation where documented.
Headers
Merchant ID when an authorized Platform acts for a connected Merchant.
Pattern:
^mer_[0-9A-Za-z]{14}$Body
application/json
ID of the terminal whose current batches to refresh (tmr_…).
Pattern:
^tmr_[0-9A-Za-z]{14}$Response
The refreshed open batches for the Terminal.

