# (NEW!) List Metadata Groups (Paginated)

Retrieve a paginated list of metadata groups for UI consumption. Supports filtering by name and usage, pagination via offset, and sorting via query parameters.

Each result includes an inUse flag, computed from whether usedIn.metadataTemplates is non-empty.

Defaults:
- inUse is unset by default, returning groups regardless of usage.

The user submitting the request must have the Metadata Management admin privilege.

Endpoint: GET /metadata/groups
Version: 1.5
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation.

## Query parameters:

  - `searchTerm` (string)
    Partial, case-insensitive match against group name. When omitted, all groups are returned (subject to pagination).
    Example: "general"

  - `inUse` (boolean)
    Filters by usage status. true returns only groups referenced by at least one template; false returns only groups not referenced by any template. Omitted applies no filter.

  - `from` (integer)
    Search offset from which results will start. Defaults to 0.

  - `limit` (integer)
    Number of results to return. Defaults to 100. Maximum 100.
    Example: 100

  - `sortField` (string)
    Field to sort by. Defaults to groupName.
    Enum: "groupName", "createdEpoch", "lastUpdatedEpoch", "inUse"

  - `order` (string)
    Sort direction. Defaults to asc.
    Enum: "asc", "desc"

## Response 200 fields (application/json):

  - `hitCount` (integer)
    Total number of groups matching the search criteria.
    Example: 12

  - `results` (array)
    Array of group summary objects.

  - `results.id` (string)
    Unique ID of the group.
    Example: "52ce0235-02cc-46f6-8bdb-05238c76bf83"

  - `results.name` (string)
    Display name of the group.
    Example: "Product Information"

  - `results.searchField` (string)
    System-generated slug.
    Example: "product_information"

  - `results.isGroupNameVisible` (boolean)
    Whether the group name is visible when rendered on an asset.

  - `results.inUse` (boolean)
    Derived from usedIn — true when usedIn.metadataTemplates is non-empty.
    Example: true

  - `results.createdEpoch` (integer)
    Creation timestamp in Unix milliseconds.
    Example: 1773070355217

  - `results.createdDate` (string)
    Human-readable creation date in ISO 8601 format.
    Example: "2026-03-20T12:05:27Z"

  - `results.lastUpdatedEpoch` (integer)
    Last updated timestamp in Unix milliseconds.
    Example: 1773070355217

  - `results.lastUpdatedDate` (string)
    Human-readable last updated date in ISO 8601 format.
    Example: "2026-03-20T12:05:27Z"

  - `results.usedIn` (object)
    Describes where the group is currently referenced.

  - `results.usedIn.metadataTemplates` (array)
    Templates that reference this group. Empty array if none.

  - `results.usedIn.metadataTemplates.id` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `results.usedIn.metadataTemplates.name` (string)
    Example: "Product Content"

## Response 400 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 401 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 403 fields (application/json):

  - `message` (string)

  - `detail` (string)