# List enrollments

Returns a paginated list of enrollments for the merchant. Soft-deleted (CANCELLED) enrollments are always excluded. Results can be filtered by location, by metadata key-value pairs, and by whether consumed enrollments are included.

Endpoint: GET /ipp/v1/enrollments
Version: 1.0.0

## Header parameters:

  - `x-merchant-id` (string, required)

## Query parameters:

  - `location_id` (string)
    Filter by location ID.

  - `metadata` (array)
    Filter by metadata key-value pair. Format: key:value. Repeat the parameter to apply multiple filters — all must match (AND semantics). Maximum 5 entries. Duplicate keys are not allowed.
    Example: "store_id:123"

  - `include_consumed` (boolean)
    Whether to include CONSUMED enrollments. Defaults to true.

  - `page_number` (integer)
    Zero-based page number. Defaults to 0.

  - `page_size` (integer)
    Page size. Defaults to 20.

## Response 200 fields (application/json):

  - `content` (array)

  - `total_elements` (integer)

  - `total_pages` (integer)

  - `page_number` (integer)

  - `page_size` (integer)

  - `first` (boolean)

  - `last` (boolean)


## Response 400 fields

## Response 401 fields