---
title: "List till sessions"
method: GET
path: "/api/business/{businessId}/branch/{branchId}/till/{tillId}/till-session"
tags: ["Till Session"]
---

# List till sessions

`GET /api/business/{businessId}/branch/{branchId}/till/{tillId}/till-session`

## Request

- Base URL: `http://api-gateway-eu.phorest.com/third-party-api-server`
- URL: `http://api-gateway-eu.phorest.com/third-party-api-server/api/business/{businessId}/branch/{branchId}/till/{tillId}/till-session`
- Auth: HTTP basic

Get a paginated list of till sessions for the specified till. Optionally filter by session start/end time range. Results are ordered by session start time, most recent first.

## Path parameters

- `businessId` string, required
- `branchId` string, required
- `tillId` string, required

## Query parameters

- `start_time` string
- `end_time` string

## Response `200`

Till sessions listed

- DataPagedModelTillSession
  - `_embedded` object
    - `tillSessions` TillSession[]
      - `tillSessionId` string: Till session ID
      - `transactionNo` integer: Sequential transaction number for this session
      - `tillId` string: ID of the till this session belongs to
      - `branchId` string: ID of the branch this session belongs to
      - `startTime` string, date-time: When the session was opened
      - `endTime` string, date-time: When the session was closed; null if still open
      - `countTime` string, date-time: When the cash was counted at close; null if not yet counted
      - `startingStaffId` string: ID of the staff member who opened the session
      - `endingStaffId` string: ID of the staff member who closed the session; null if still open
      - `countingStaffId` string: ID of the staff member who performed the cash count; null if not yet counted
      - `systemCounted` boolean: Whether the cash count was performed automatically by the system
      - `openingCashAmount` number: Cash amount in the drawer at session open
      - `closingCashAmount` number: Cash amount in the drawer at session close
      - `counts` TillSessionCount[]: Per-payment-type amounts recorded during the cash-count close
        - `type` 'CASH' | 'CREDIT' | 'DEBIT' | 'PHOREST_PAY_CREDIT_CARD' | 'PHOREST_PAY_DEBIT_CARD' | 'CHEQUE' | 'VOUCHER' | 'ACCOUNT' | 'MEMBERSHIP' | 'APPOINTMENT_DEPOSIT' | 'OTHER': Payment type. Supplemental (custom) payment types are represented as OTHER with a non-null supplementalPaymentTypeId.
        - `supplementalPaymentTypeId` string: ID of the supplemental payment type; null for standard types like CASH or CARD
        - `amount` number: Counted amount for this payment type
      - `notes` string: Free-text notes recorded on the session
      - `createTime` string, date-time
      - `updateTime` string, date-time
  - `page` PageMetadata
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer
    - `number` integer

## Other responses

- `400`: Bad Request
- `404`: Business, branch, or till with the specified ids don't exist
- `429`: Request rate limit exceeded. Current limit set to 100 rps.
- `500`: Internal Server Error

## Changes

- **2026-11-03** `beea6ef29634`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phorest/apis/third-party-api/changes/api/business/:businessId/branch/:branchId/till/:tillId/till-session/get.md)

---

[API](https://skmtc.dev/phorest/apis/third-party-api.md) - [All operations](https://skmtc.dev/phorest/apis/third-party-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phorest/apis/third-party-api/revisions/beea6ef29634?raw)