PHphorest
Till Session

List till sessions

Changed on

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.

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

Request

Path parameters

businessIdstring required
branchIdstring required
tillIdstring required

Query parameters

start_timestring

Returns sessions ending at or after this ISO-8601 datetime. Open (unclosed) sessions are always included regardless of this value.

end_timestring

Returns sessions starting strictly before this ISO-8601 datetime.

number of records to return, max is 200

page number, default is 0

Response

Till sessions listed

Example response

{
  "_embedded": {
    "tillSessions": [
      {
        "tillSessionId": "eTC3QY5W3p_HmGHezKfxJw",
        "transactionNo": 42,
        "tillId": "eTC3QY5W3p_HmGHezKfxJw",
        "branchId": "eTC3QY5W3p_HmGHezKfxJw",
        "startTime": "2025-06-10T09:00:00Z",
        "endTime": "2025-06-10T17:30:00Z",
        "countTime": "2025-06-10T17:35:00Z",
        "startingStaffId": "eTC3QY5W3p_HmGHezKfxJw",
        "endingStaffId": "eTC3QY5W3p_HmGHezKfxJw",
        "countingStaffId": "eTC3QY5W3p_HmGHezKfxJw",
        "openingCashAmount": 200,
        "closingCashAmount": 350,
        "counts": [
          {
            "type": "CASH",
            "supplementalPaymentTypeId": "eTC3QY5W3p_HmGHezKfxJw",
            "amount": 150
          }
        ],
        "notes": "Short by 5.00 - investigated",
        "createTime": "2025-06-10T09:00:00Z",
        "updateTime": "2025-06-10T17:35:00Z"
      }
    ]
  }
}

Changes