---
title: 'Get Loyalty Rule Statuses'
description: 'Retrieve loyalty rule statuses'
openapi: GET /api/loyalty/rule_statuses
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`GET /api/loyalty/rule_statuses` — query parameters: `organizationId`, `websiteId`, `walletAddress`, `userId`, `userGroupId`, `userGroupExternalIdentifier`, `loyaltyRuleId`, `limit`, `startingAfter`

`GET https://admin.snagsolutions.io/api/loyalty/rule_statuses`

Retrieve loyalty rule statuses

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Query parameters

- `organizationId` (string) — Unique identifier for the organization
- `websiteId` (string) — Unique identifier for the website
- `walletAddress` (string) — Wallet address(es) to filter accounts by
- `userId` (string) — User ID(s) to filter accounts by
- `userGroupId` (string)
- `userGroupExternalIdentifier` (string)
- `loyaltyRuleId` (string) — Unique identifier(s) for the loyalty rule(s). Accepts a single ID or an array (up to 100); for larger sets, batch requests to avoid URL length limits.
- `limit` (number) — Number of items to return
- `startingAfter` (string) — Starting after item

## Response 200

200
  - response (object)
    - `data` (array, required)
      - `items` (object)
        - `id` (string, uuid, required)
        - `websiteId` (string, uuid, required)
        - `organizationId` (string, uuid, required)
        - `userId` (string, uuid, required)
        - `loyaltyRuleId` (string, uuid, required)
        - `progress` (number, required)
        - `createdAt` (string, date-time, required)
        - `updatedAt` (string, date-time, required)
    - `hasNextPage` (boolean, required)

## Response 403

403
  - response (object) — Schema for forbidden response
    - `message` (string, required) — Error message


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip