A valid request URL is required to generate request examples{
"items": [
{
"id": "lm-camille",
"customerName": "Camille Renard",
"tier": "Or",
"balance": 1240,
"lifetimePoints": 1820,
"status": "active"
}
],
"total": 8,
"page": 1,
"pageSize": 20,
"pageCount": 1
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}List loyalty members (fidélité)
Returns one page of the loyalty member directory: who is enrolled, their tier label, redeemable balance and monotonic lifetimePoints. Use it to browse or to find a member id; when you already hold a CUSTOMER id and want the live balance, call getLoyaltyAccount instead — that one recomputes from the ledger. Filter with tier (e.g. Or) and status (active / suspended), order with sortField (customerName / lifetimePoints), and walk with page/pageSize (max 100).
A valid request URL is required to generate request examples{
"items": [
{
"id": "lm-camille",
"customerName": "Camille Renard",
"tier": "Or",
"balance": 1240,
"lifetimePoints": 1820,
"status": "active"
}
],
"total": 8,
"page": 1,
"pageSize": 20,
"pageCount": 1
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Query Parameters
1-based page index to return. Defaults to 1.
1 <= x <= 9007199254740991Rows per page, 1..100. Defaults to 20.
1 <= x <= 100Exact loyalty-tier label to filter on (fidélité/palier), e.g. Or.
1Membership status to filter on, e.g. active / suspended.
1Field to order by: customerName or lifetimePoints.
customerName, lifetimePoints Order direction for sortField (default asc).
asc, desc Response
A page of loyalty members with the pagination totals.
A page of loyalty members with the pagination totals.
The rows on this page, in the query's sort order.
Show child attributes
Show child attributes
Total rows matching the filter across ALL pages, not just this one.
0 <= x <= 9007199254740991The 1-based page number served.
0 < x <= 9007199254740991Rows requested per page.
0 < x <= 9007199254740991Total number of pages; stop walking when page reaches it.
0 <= x <= 9007199254740991