v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01934981.1 MB
Programs

List programs

<Warning>

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Returns a cursor-paginated list of loyalty programs. Supports filtering by id, name, status and created_at. The same field cannot be used in both ascending and descending order at once.

get/v2/loyalties/programs

Query parameters

junction'AND' | 'OR' nullable

Logical junction applied between field filters. Defaults to AND.

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.

number
OR
string

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

string[]
OR
'-created_at' | 'created_at' | 'name' | '-name'

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.

cursorstring nullable

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

Response

Paginated list of programs.

object'list'

Object type marker.

All 93 operations