A valid request URL is required to generate request examples{
"data": [
{
"id": "lmbr_12c3092a048ffa1a33",
"customer_id": "cust_RhnOBUBSf2lVKz74eKCHnEs4",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-21T15:04:36.114Z",
"updated_at": null,
"object": "member"
},
{
"id": "lmbr_12ba1c1a8456b6db8c",
"customer_id": "cust_X07elh40iNWLujRmDNmBufxd",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-14T16:41:01.201Z",
"updated_at": null,
"object": "member"
}
],
"cursor": {
"next": "lcrsmbr_12f8ff4b05eed6b35a",
"expires_at": "2026-09-01T13:09:27.127Z"
},
"object": "list"
}List program members
Returns a cursor-paginated list of members of the program. Results can be filtered by ID, status, customer ID and creation date. Results can be ordered by creation date, status, or customer ID (ascending or descending). The same field cannot be ordered both ascending and descending at the same time.
Returns 404 when the program does not exist.
List items do not include the cards array. Use the following endpoints to retrieve cards for a given member:
curl --request GET \
--url {protocol}://{host}/v2/loyalties/programs/{programId}/members \
--header 'X-App-Id: <api-key>' \
--header 'X-App-Token: <api-key>'{
"data": [
{
"id": "lmbr_12c3092a048ffa1a33",
"customer_id": "cust_RhnOBUBSf2lVKz74eKCHnEs4",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-21T15:04:36.114Z",
"updated_at": null,
"object": "member"
},
{
"id": "lmbr_12ba1c1a8456b6db8c",
"customer_id": "cust_X07elh40iNWLujRmDNmBufxd",
"program_id": "lprg_128f58429f4c4bf7b2",
"status": "ACTIVE",
"metadata": {},
"created_at": "2026-07-14T16:41:01.201Z",
"updated_at": null,
"object": "member"
}
],
"cursor": {
"next": "lcrsmbr_12f8ff4b05eed6b35a",
"expires_at": "2026-09-01T13:09:27.127Z"
},
"object": "list"
}Authorizations
Path Parameters
Unique loyalty program ID (format lprg_[a-f0-9]+).
^lprg_[a-f0-9]+$Query Parameters
Maximum number of members to return. Must be between 1 and 100. Defaults to 10 when not provided.
1 <= x <= 100Field(s) to order results by. Prefix with - for descending order. Accepts a single value or an array of values. Defaults to -created_at. Ordering by the same field in both directions simultaneously is rejected.
-created_at, created_at, status, -status, customer_id, -customer_id Pagination cursor returned in the cursor.next field of a previous response. Must match the pattern ^lcrsmbr_[a-f0-9]+$.
^lcrsmbr_[a-f0-9]+$Field-specific filter conditions, passed as a deep object, e.g. filters[status][conditions][$is]=ACTIVE.
Request query schema for GET /v2/loyalties/programs/{programId}/members.
Show child attributes
Show child attributes
Response
Cursor-paginated list of members.
Response body schema for GET /v2/loyalties/programs/{programId}/members.
Was this page helpful?