# List product metadata

Retrieves a paginated list of metadata entries for a product.

Endpoint: GET /v1/products/{productUuid}/metadata
Version: 1.0.0
Security: Bearer

## Path parameters:

  - `productUuid` (string, required)
    Unique identifier of the product.

## Query parameters:

  - `uuids[eq]` (array)
    Filter by specific metadata entry UUIDs.

  - `localeUuids[eq]` (array)
    Filter by specific locale UUIDs.

  - `type[eq]` (string)
    Filter by exact metadata type match.

  - `type[order]` (string)
    Sort order for type field. Values: asc, desc.

  - `key[eq]` (string)
    Filter by exact key match.

  - `key[order]` (string)
    Sort order for key field. Values: asc, desc.

  - `createdAt[eq]` (string)
    Filter by exact creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[min]` (string)
    Filter by minimum creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[max]` (string)
    Filter by maximum creation timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `createdAt[order]` (string)
    Sort order for creation timestamp. Values: asc, desc.

  - `updatedAt[eq]` (string)
    Filter by exact update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[min]` (string)
    Filter by minimum update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[max]` (string)
    Filter by maximum update timestamp.
    Example: "2025-11-23T14:15:22.123456Z"

  - `updatedAt[order]` (string)
    Sort order for update timestamp. Values: asc, desc.

  - `page` (integer)
    Page number for pagination. Default is 1.

  - `size` (integer)
    Page size for pagination. Default is 20.

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.uuid` (string, required)
    Unique identifier for this metadata entry.

  - `items.productUuid` (string, required)
    Identifier of the product this metadata belongs to.

  - `items.localeUuid` (string, required)
    Identifier of the locale this metadata is associated with.

  - `items.createdAt` (string, required)
    Timestamp when this metadata entry was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.updatedAt` (string, required)
    Timestamp when this metadata entry was last modified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `items.type` (string, required)
    Data type of the metadata value.
    Enum: "string", "number", "boolean", "json"

  - `items.key` (string, required)
    Metadata key identifier.

  - `items.value` (string, required)
    Metadata value content.

  - `pagination` (object, required)

  - `pagination.page` (integer, required)

  - `pagination.size` (integer, required)

  - `pagination.totalItems` (integer, required)

  - `pagination.totalPages` (integer, required)

## Response 401 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 403 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)

## Response 500 fields (application/problem+json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

  - `correlationId` (string,null)