> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionicfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Terminal batch items

> Lists the transaction records in the batch's latest persisted snapshot.



## OpenAPI

````yaml /openapi/terminal-management.yaml get /terminal_batches/{id}/items
openapi: 3.0.3
info:
  title: Ionic Terminal Management API
  version: '2026-08-26'
  description: |
    Request physical Terminal hardware, inspect Merchant-owned Terminals, and
    read Ionic's terminal batch and settlement records.

    Every resource is scoped to the authenticated Merchant and the secret
    key's test or live mode. Request bodies never select `merchant_id` or
    `livemode`. Platforms can use `Ionic-Account` on delegated reads and
    provisioning requests; batch refresh is available only to a Merchant's
    own secret key.
servers:
  - url: '{baseUrl}/v1'
    variables:
      baseUrl:
        default: https://api.ionicfi.com
        description: API base URL for the selected environment.
security:
  - secretKey: []
tags:
  - name: Terminal Provisioning
    description: Request physical hardware and track fulfillment.
  - name: Terminals
    description: Inspect Merchant-owned Terminal inventory and readiness.
  - name: Terminal Batches
    description: Read Ionic batch, item, and settlement records.
paths:
  /terminal_batches/{id}/items:
    get:
      tags:
        - Terminal Batches
      summary: List Terminal batch items
      description: Lists the transaction records in the batch's latest persisted snapshot.
      operationId: listTerminalBatchItems
      parameters:
        - $ref: '#/components/parameters/TerminalBatchId'
        - $ref: '#/components/parameters/IonicAccount'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/StartingAfter'
      responses:
        '200':
          description: A page of batch items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TerminalBatchItemList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/ReadForbidden'
        '404':
          $ref: '#/components/responses/BatchNotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - secretKey:
            - terminals:read
components:
  parameters:
    TerminalBatchId:
      name: id
      in: path
      required: true
      description: Ionic Terminal batch ID.
      schema:
        type: string
        pattern: ^tmb_[0-9A-Za-z]{24}$
    IonicAccount:
      name: Ionic-Account
      in: header
      required: false
      description: Merchant ID when an authorized Platform acts for a connected Merchant.
      schema:
        type: string
        pattern: ^mer_[0-9A-Za-z]{14}$
    Limit:
      name: limit
      in: query
      required: false
      description: Page size. Defaults to 20 and cannot exceed 100.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
    StartingAfter:
      name: starting_after
      in: query
      required: false
      description: Return objects after this resource ID.
      schema:
        type: string
  schemas:
    TerminalBatchItemList:
      allOf:
        - $ref: '#/components/schemas/ListBase'
        - type: object
          required:
            - data
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/TerminalBatchItem'
    ListBase:
      type: object
      required:
        - object
        - has_more
      properties:
        object:
          type: string
          enum:
            - list
        has_more:
          type: boolean
        next_cursor:
          type: string
          nullable: true
    TerminalBatchItem:
      type: object
      additionalProperties: false
      required:
        - id
        - object
        - batch_id
        - merchant_id
        - livemode
        - operation
        - amount
        - currency
        - external_reference
        - charge_id
        - refund_id
        - occurred_at
        - created_at
      properties:
        id:
          type: string
          pattern: ^tbi_[0-9A-Za-z]{24}$
        object:
          type: string
          enum:
            - terminal_batch_item
        batch_id:
          type: string
          pattern: ^tmb_[0-9A-Za-z]{24}$
        merchant_id:
          type: string
          pattern: ^mer_[0-9A-Za-z]{14}$
        livemode:
          type: boolean
        operation:
          type: string
          enum:
            - sale
            - refund
            - void
            - reversal
            - authorization
            - ticket
            - tip_adjustment
        amount:
          type: integer
          format: int64
          description: Integer minor units.
        currency:
          type: string
          pattern: ^[a-z]{3}$
        external_reference:
          type: string
          nullable: true
        charge_id:
          type: string
          nullable: true
        refund_id:
          type: string
          nullable: true
        occurred_at:
          type: integer
          format: int64
          nullable: true
        created_at:
          type: integer
          format: int64
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  responses:
    BadRequest:
      description: Invalid JSON, identifier, fields, filters, or cursor.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ReadForbidden:
      description: Invalid delegation or missing `terminals:read` permission.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BatchNotFound:
      description: The Terminal batch was not found for the Merchant and key mode.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      bearerFormat: Ionic secret key
      description: >-
        Merchant secret key, or an authorized Platform secret key with
        delegation where documented.

````