---
name: terminals-routes
description: Handle 15 OpenAPI operation(s) under /v2/terminals for the terminals route group.
---

# terminals API Routes

Handle 15 OpenAPI operation(s) under /v2/terminals for the terminals route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

## Operations

### create_terminal_action

- Operation ID: `create_terminal_action`
- Route: `POST /v2/terminals/actions`
- Mode: WRITE
- Summary: CreateTerminalAction
- Body: JSON request body accepted.

### search_terminal_actions

- Operation ID: `search_terminal_actions`
- Route: `POST /v2/terminals/actions/search`
- Mode: WRITE
- Summary: SearchTerminalActions
- Body: JSON request body accepted.

### get_terminal_action

- Operation ID: `get_terminal_action`
- Route: `GET /v2/terminals/actions/{action_id}`
- Mode: READ
- Summary: GetTerminalAction
- Parameters:
  - `action_id` in `path` required

### cancel_terminal_action

- Operation ID: `cancel_terminal_action`
- Route: `POST /v2/terminals/actions/{action_id}/cancel`
- Mode: WRITE
- Summary: CancelTerminalAction
- Parameters:
  - `action_id` in `path` required

### dismiss_terminal_action

- Operation ID: `dismiss_terminal_action`
- Route: `POST /v2/terminals/actions/{action_id}/dismiss`
- Mode: WRITE
- Summary: DismissTerminalAction
- Parameters:
  - `action_id` in `path` required

### create_terminal_checkout

- Operation ID: `create_terminal_checkout`
- Route: `POST /v2/terminals/checkouts`
- Mode: WRITE
- Summary: CreateTerminalCheckout
- Body: JSON request body accepted.

### search_terminal_checkouts

- Operation ID: `search_terminal_checkouts`
- Route: `POST /v2/terminals/checkouts/search`
- Mode: WRITE
- Summary: SearchTerminalCheckouts
- Body: JSON request body accepted.

### get_terminal_checkout

- Operation ID: `get_terminal_checkout`
- Route: `GET /v2/terminals/checkouts/{checkout_id}`
- Mode: READ
- Summary: GetTerminalCheckout
- Parameters:
  - `checkout_id` in `path` required

### cancel_terminal_checkout

- Operation ID: `cancel_terminal_checkout`
- Route: `POST /v2/terminals/checkouts/{checkout_id}/cancel`
- Mode: WRITE
- Summary: CancelTerminalCheckout
- Parameters:
  - `checkout_id` in `path` required

### dismiss_terminal_checkout

- Operation ID: `dismiss_terminal_checkout`
- Route: `POST /v2/terminals/checkouts/{checkout_id}/dismiss`
- Mode: WRITE
- Summary: DismissTerminalCheckout
- Parameters:
  - `checkout_id` in `path` required

### create_terminal_refund

- Operation ID: `create_terminal_refund`
- Route: `POST /v2/terminals/refunds`
- Mode: WRITE
- Summary: CreateTerminalRefund
- Body: JSON request body accepted.

### search_terminal_refunds

- Operation ID: `search_terminal_refunds`
- Route: `POST /v2/terminals/refunds/search`
- Mode: WRITE
- Summary: SearchTerminalRefunds
- Body: JSON request body accepted.

### get_terminal_refund

- Operation ID: `get_terminal_refund`
- Route: `GET /v2/terminals/refunds/{terminal_refund_id}`
- Mode: READ
- Summary: GetTerminalRefund
- Parameters:
  - `terminal_refund_id` in `path` required

### cancel_terminal_refund

- Operation ID: `cancel_terminal_refund`
- Route: `POST /v2/terminals/refunds/{terminal_refund_id}/cancel`
- Mode: WRITE
- Summary: CancelTerminalRefund
- Parameters:
  - `terminal_refund_id` in `path` required

### dismiss_terminal_refund

- Operation ID: `dismiss_terminal_refund`
- Route: `POST /v2/terminals/refunds/{terminal_refund_id}/dismiss`
- Mode: WRITE
- Summary: DismissTerminalRefund
- Parameters:
  - `terminal_refund_id` in `path` required