# (NEW!) List Metadata Attributes (Paginated)

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

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

Defaults:
- attributeType, inUse, and filterFor are unset by default, applying no filter.

Business Rules:
- attributeType accepts one or more of textbox, textarea, date, dropdown as a comma-separated list.
- inUse accepts a boolean (true/false — aggregate: used anywhere at all) or one of metadataCascades, metadataTables, metadataGroups, metadataTemplates, presets, filtering to attributes referenced in that specific usage category.
- filterFor filters to attributes usable in a specific consumer context. Currently supports requestInbox, which returns only attributes that can be set as Request Inbox columns.

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"

  - `attributeType` (string)
    Comma-separated list of attribute types to filter by. One or more of textbox, textarea, date, dropdown. Omitted returns attributes of any type.
    Example: "textbox,textarea,date"

  - `inUse` (string)
    Filters by usage status. true/false filters on aggregate usage (referenced anywhere at all). One of metadataCascades, metadataTables, metadataGroups, metadataTemplates, presets filters to attributes referenced in that specific usage category. Omitted applies no filter.
    Enum: "true", "false", "metadataCascades", "metadataTables", "metadataGroups", "metadataTemplates", "presets"

  - `filterFor` (string)
    Filters to attributes usable in a specific consumer context. Currently supports requestInbox, which returns only attributes that can be set as Request Inbox columns.
    Enum: "requestInbox"

  - `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", "attributeType", "inUse"

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