# (NEW!) List Metadata Groups (Paginated)

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

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"

  - `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"

  - `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.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)