Skip to main content
GET
/
v2
/
loyalties
/
programs
Error
A valid request URL is required to generate request examples
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "start_date": "2023-11-07T05:31:56Z",
      "end_date": "2023-11-07T05:31:56Z",
      "validity_hours": {
        "daily": [
          {
            "days_of_week": [
              3
            ],
            "start_time": "<string>",
            "end_time": "<string>"
          }
        ]
      },
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "cursor": {
    "next": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  }
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id
string
header
required
X-App-Token
string
header
required

Query Parameters

filters
object | null

Filters for the program list. Nested object serialized in the query string (e.g. filters[status][conditions][$is]=ACTIVE). Each field accepts a conditions object with at least one condition. Only the condition operators supported by each field type are allowed.

Filters accepted by the program list endpoint.

limit
default:10

Maximum number of items to return. Between 1 and 100. Defaults to 10. Non-integer values are rounded.

Required range: 1 <= x <= 100
order

Sorting order. A single value or an array of values. Prefix a field with - for descending order. Defaults to -created_at. The same field cannot be used in both ascending and descending order at once.

Available options:
-created_at,
created_at,
name,
-name
cursor
string | null

Pagination cursor returned by a previous call (cursor.next).

Pattern: ^lcrsprg_[a-f0-9]+$

Response

Paginated list of programs.

Cursor-paginated list of programs.

object
string

Object type marker.

Allowed value: "list"
data
object[]

Programs on the current page.

cursor
object | null

Pagination cursor, or null when there are no more results.

Last modified on July 9, 2026