# (COMING SOON!) List Metadata Templates (Paginated)

🚧 Coming Soon — This endpoint is not yet available.

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

Each result includes the full template object with templateDenormalized, attributesDefaultValue, accessTemplates, and an inUse flag indicating whether the template is currently assigned to any assets.

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

Endpoint: GET /metadata/templates
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 template name. When omitted, all templates are returned (subject to pagination).
    Example: "video"

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

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

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

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

## Response 200 fields (application/json):

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

  - `results` (array)
    Array of template objects.

  - `results.templateId` (string)

  - `results.name` (string)

  - `results.customerId` (string)

  - `results.createdBy` (string)

  - `results.createdEpoch` (integer)

  - `results.createdDate` (string)

  - `results.lastUpdatedBy` (string)

  - `results.lastUpdatedEpoch` (integer)

  - `results.lastUpdatedDate` (string)

  - `results.groupIds` (array)

  - `results.templateType` (array)

  - `results.attributesDefaultValue` (array)

  - `results.attributesDefaultValue.searchField` (string)

  - `results.attributesDefaultValue.value` (any)
    Default value for the attribute.

  - `results.accessTemplates` (array)

  - `results.inUse` (boolean)
    Whether this template is currently assigned to any assets.

  - `results.templateDenormalized` (object)
    System-generated denormalized template structure.

  - `results.templateDenormalized.metadataGroups` (array)

  - `results.templateDenormalized.metadataGroups.groupOrder` (integer)

  - `results.templateDenormalized.metadataGroups.metadataGroupName` (string)

  - `results.templateDenormalized.metadataGroups.isGroupNameVisible` (boolean)

  - `results.templateDenormalized.metadataGroups.metadataGroupSearchField` (string)

  - `results.templateDenormalized.metadataGroups.securityPermissions` (array)

  - `results.templateDenormalized.metadataGroups.metadataAttributes` (array)
    Ordered list of attributes. Shape varies by type:
- text (subType: textBox/textArea) — includes length, techMetaMapping
- controlledVocabulary — includes controlledVocabularyId, isMultipleSelect
- date — includes dateFormat
- tableAttribute — includes tableFieldsDenormalized, isSingleRow, isSmartTable
- cascadeAttribute — includes cascadeMapId, cascadeFieldsDenormalized

## 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)