# List enrollments

> `GET https://api.kustom.co/ipp/v1/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.

## Parameters

- `location_id` (string, query) — Filter by location ID.
- `metadata` (array<string>, query) — 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.
- `include_consumed` (boolean, query) — Whether to include CONSUMED enrollments. Defaults to true.
- `page_number` (integer, query) — Zero-based page number. Defaults to 0.
- `page_size` (integer, query) — Page size. Defaults to 20.

## Responses

### 200

Paginated list of enrollments.

`application/json`

- `content[]` (array<any>)
- `total_elements` (integer)
- `total_pages` (integer)
- `page_number` (integer)
- `page_size` (integer)
- `first` (boolean)
- `last` (boolean)

```json
{
  "content": [
    "<string>"
  ],
  "total_elements": 0,
  "total_pages": 0,
  "page_number": 0,
  "page_size": 0,
  "first": false,
  "last": false
}
```

### 400

Invalid request parameters.

`application/json`

### 401

Missing or invalid credentials.

`application/json`