# Get redemption types

Get all available redemption types for client reference. Requires valid project API key. Use pagination parameters (page & limit) for optimal performance. Legacy support: returns array without params (deprecated - will be removed in future).

Endpoint: GET /redemptions/types
Version: 2.0.53
Security: projectKey

## Query parameters:

  - `page` (string)
    Page number for pagination (1-based)

  - `limit` (string)
    Number of items per page

## Response 200 fields (application/json):

  - `name` (string, required)
    Redemption type name

  - `description` (string)
    Redemption type description

  - `imageUrl` (string)
    Redemption type image url

  - `baseRequiredUserFields` (array)
    Base required user fields for all redemptions of this type. Can include built-in field keys (email, firstName) or custom field definition UUIDs.

  - `bookingRequirement` (object)
    Default booking requirement config for all redemptions of this type. Individual redemptions can override.

  - `bookingRequirement.type` (string, required)
    Type of booking required for eligibility.
    Enum: "active", "future", "past", "active_future", "any"

  - `bookingRequirement.eligibleBusinessIds` (array)
    Specific business IDs where booking must be. `null` = any business allowed, `[]` = no businesses allowed (blocks all). Combined with eligibleBusinessTypeIds via OR.

  - `bookingRequirement.eligibleBusinessTypeIds` (array)
    Business type IDs where booking must be. `null` = any type allowed, `[]` = no types allowed (blocks all). Combined with eligibleBusinessIds via OR.

  - `id` (number, required)
    Redemption type id