Skip to content
GET

List enrollments

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.

Parameters5 fields
  • location_idstring · uuidoptionalin query

    Filter by location ID.

  • metadataarray<string>optionalin 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_consumedbooleanoptionalin query

    Whether to include CONSUMED enrollments. Defaults to true.

  • page_numberinteger · int32optionalin query

    Zero-based page number. Defaults to 0.

  • page_sizeinteger · int32optionalin query

    Page size. Defaults to 20.

200
Response7 fields

Paginated list of enrollments.

  • content[]array<any>optional
  • total_elementsinteger · int64optional
  • total_pagesinteger · int32optional
  • page_numberinteger · int32optional
  • page_sizeinteger · int32optional
  • firstbooleanoptional
  • lastbooleanoptional
400
Response0 fields

Invalid request parameters.

No response body — this status returns headers only.

401
Response0 fields

Missing or invalid credentials.

No response body — this status returns headers only.

This page is also available as Markdown — append .md to its URL — and is indexed in llms.txt.