List POS sessions
GET/pos/sessions
Returns paginated cashier sessions ordered by most recently opened. Use the optional status filter to scope results to open or closed sessions. Each session includes the associated register and user.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter sessions by status. Omit to return all sessions. One of: |
page | integer | No | Page number for pagination (20 sessions per page). Default: |
Responses
200 Paginated list of POS sessions
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · PosSessionV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].session_number | string | No | Human-readable session reference number (e.g. "SES-00045"). Example: |
data[].register_id | integer | No | ID of the register this session is on. Example: |
data[].user_id | integer | No | ID of the authenticated tenant user (cashier) who owns this session. Example: |
data[].opening_float | number | No | Cash declared in the till at session open. Example: |
data[].actual_cash | number, nullable | No | Physical cash counted at session close. Example: |
data[].status | string | No | Whether the session is currently active or has been closed. One of: |
data[].opened_at | string (date-time) | No | Timestamp when the session was opened. |
data[].closed_at | string (date-time), nullable | No | Timestamp when the session was closed. |
data[].notes | string, nullable | No | Operator notes about the session. |
meta | object | No | |
meta.current_page | integer | No | |
meta.per_page | integer | No | |
meta.total | integer | No |
Example
{
"data": [
{
"id": 45,
"session_number": "SES-00045",
"register_id": 3,
"user_id": 12,
"opening_float": 200.0,
"actual_cash": 385.5,
"status": "closed",
"opened_at": "2026-04-07T08:00:00Z",
"closed_at": "2026-04-07T17:00:00Z",
"notes": "Regular Monday shift"
}
],
"meta": {
"current_page": 1,
"per_page": 20,
"total": 45
}
}401 Unauthenticated
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/pos/sessions" \
-H "Accept: application/json"