# (NEW!) List Metadata Attributes (Paginated)

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

This endpoint replaces the unpaginated GET /metadata/attributes for customers with large attribute libraries.

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

Endpoint: GET /attributes
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 attribute name. When omitted or when * is passed, all attributes are returned (subject to pagination).
    Example: "title"

  - `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 attributeName.
    Enum: "attributeName", "createdEpoch", "lastUpdatedEpoch"

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

## Response 200 fields (application/json):

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

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

  - `results.id` (string)
    Unique ID of the attribute.
    Example: "8a481dd2-24c1-4c54-a84f-0aded1e985e7"

  - `results.name` (string)
    Display name of the attribute.
    Example: "Asset Title"

  - `results.searchField` (string)
    System-generated slug used for search indexing.
    Example: "asset_title"

  - `results.attributeType` (string)
    Type of the attribute.
    Enum: "textbox", "textarea", "date", "dropdown"

  - `results.isFeatured` (boolean)
    Whether this is a featured attribute.

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

  - `results.createdDate` (string)
    Human-readable creation date in ISO 8601 format.
    Example: "2026-03-11T14:32:35Z"

  - `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-11T14:32:35Z"

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

  - `results.usedIn.metadataCascades` (array)
    Cascades that reference this attribute. Empty array if none.

  - `results.usedIn.metadataCascades.id` (string)
    Example: "c1d2e3f4-1234-5678-abcd-ef1234567890"

  - `results.usedIn.metadataCascades.name` (string)
    Example: "General Cascade"

  - `results.usedIn.metadataTables` (array)
    Tables that reference this attribute. Empty array if none.

  - `results.usedIn.metadataGroups` (array)
    Groups that contain this attribute. Empty array if none.

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

  - `results.usedIn.presets` (array)
    Filter presets that reference this attribute. Empty array if none.

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