GuidesAPI Reference
Log In
API Reference
These docs are for v2025.2.0. Click to read the latest docs for v2026.2.0.

List customer loyalty programs

Returns a paginated list of loyalty programs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
uri
length ≥ 1

This URL will be invoked when results are ready for retrieval. The payload will contain the location of the results file. Use the Check Deferred Execution Status API to poll for status, or include a value for callback_url to be notified when results are ready.

date-time

Filter upon the create date/time using ISO8601 format. Assumption is UTC unless TZ offset is specified.

integer

Optional parameter to filter response by customer id.

string

Optional parameter to filter response by customer number.

boolean

Set to true to request asynchronous processing, which is required for larger data requests.

integer

Maximum number of results per page. The default is 25.

string

Optional parameter to filter response by loyalty program name.

integer
enum
  • 1 - Pending
  • 10 - Active
  • 20 - Canceled
  • 30 - Expired
  • 40 - Need Customer Information
  • 50 - Inactive
Allowed:
string

Optional parameter to filter response by membership number.

string

Fields to order upon. Valid fields include: customer_id

integer

Page of results to retrieve

date-time

Filter upon the update date/time using ISO8601 format. Assumption is UTC unless TZ offset is specified.

Headers
integer
required

The id of the active store to be used for this API invocation

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json