# Get product

Retrieves complete details for a single product with optional hydration.

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

## Path parameters:

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

## Query parameters:

  - `include[productAssets]` (boolean)
    Include product asset junction UUIDs. Values: true, false.

  - `expand[productAssets]` (boolean)
    Expand product asset junctions with full details. Values: true, false.

  - `include[productAttributes]` (boolean)
    Include product attribute junction UUIDs. Values: true, false.

  - `expand[productAttributes]` (boolean)
    Expand product attribute junctions with full details. Values: true, false.

  - `include[productAttributeTerms]` (boolean)
    Include product attribute term junction UUIDs. Values: true, false.

  - `expand[productAttributeTerms]` (boolean)
    Expand product attribute term junctions with full details. Values: true, false.

  - `include[productCategories]` (boolean)
    Include product category junction UUIDs. Values: true, false.

  - `expand[productCategories]` (boolean)
    Expand product category junctions with full details. Values: true, false.

  - `include[productTags]` (boolean)
    Include product tag junction UUIDs. Values: true, false.

  - `expand[productTags]` (boolean)
    Expand product tag junctions with full details. Values: true, false.

  - `include[contents]` (boolean)
    Include content UUIDs. Values: true, false.

  - `expand[contents]` (boolean)
    Expand localized content with full details. Values: true, false.

  - `include[metadata]` (boolean)
    Include metadata UUIDs. Values: true, false.

  - `expand[metadata]` (boolean)
    Expand metadata with full details. Values: true, false.

  - `include[relations]` (boolean)
    Include relation UUIDs. Values: true, false.

  - `expand[relations]` (boolean)
    Expand product relations with full details. Values: true, false.

  - `expand[completeness]` (boolean)
    Expand completeness data with dimension scores and issues. Values: true, false.

## Response 200 fields (application/json):

  - `uuid` (string, required)
    Unique identifier for this product.

  - `familyUuid` (string,null)
    Identifier of the family defining structure and requirements for this product.

  - `skuUuid` (string,null)
    Identifier of the SKU providing inventory and dimensional data.

  - `parentUuid` (string,null)
    Identifier of the parent product for variant relationships.

  - `brandUuid` (string,null)
    Identifier of the brand associated with this product.

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

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

  - `removedAt` (string,null)
    Timestamp when this product was removed. Null if not removed.
    Example: "2025-11-23T14:15:22.123456Z"

  - `archivedAt` (string,null)
    Timestamp when this product was archived. Null if not archived.
    Example: "2025-11-23T14:15:22.123456Z"

  - `status` (string, required)
    Current lifecycle status of this product.
    Enum: "draft", "published", "unpublished", "archived", "removed"

  - `type` (string, required)
    Product type defining variant behavior.
    Enum: "simple", "variantParent", "variant"

  - `code` (string, required)
    Unique code identifier for this product.

  - `overallScore` (integer, required)
    Completeness score from 0-100 indicating how complete this product is.

  - `canPublish` (boolean, required)
    Whether this product meets all required criteria for publishing.

  - `productAssetUuids` (array,null)
    Collection of product-asset junction UUIDs. Populated when include[productAssets]=true.

  - `productAssets` (array,null)
    Collection of product-asset junctions. Populated when expand[productAssets]=true.

  - `productAssets.uuid` (string, required)
    Unique identifier for this product-asset association.

  - `productAssets.productUuid` (string, required)
    Identifier of the product this asset is linked to.

  - `productAssets.assetUuid` (string, required)
    Identifier of the linked asset.

  - `productAssets.productAssetTypeUuid` (string, required)
    Identifier of the product asset type.

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

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

  - `productAssets.order` (integer, required)
    Display order for this asset in product galleries.

  - `productAttributeUuids` (array,null)
    Collection of product-attribute junction UUIDs. Populated when include[productAttributes]=true.

  - `productAttributes` (array,null)
    Collection of product-attribute junctions. Populated when expand[productAttributes]=true.

  - `productAttributes.uuid` (string, required)
    Unique identifier for this product-attribute association.

  - `productAttributes.productUuid` (string, required)
    Identifier of the product this attribute is linked to.

  - `productAttributes.attributeUuid` (string, required)
    Identifier of the linked attribute.

  - `productAttributes.isVariant` (boolean, required)
    Whether this attribute is used to define product variants.

  - `productAttributeTermUuids` (array,null)
    Collection of product-term junction UUIDs. Populated when include[productAttributeTerms]=true.

  - `productAttributeTerms` (array,null)
    Collection of product-term junctions. Populated when expand[productAttributeTerms]=true.

  - `productAttributeTerms.uuid` (string, required)
    Unique identifier for this product-term association.

  - `productAttributeTerms.productUuid` (string, required)
    Identifier of the product this term is linked to.

  - `productAttributeTerms.productAttributeUuid` (string, required)
    Identifier of the product attribute.

  - `productAttributeTerms.attributeTermUuid` (string, required)
    Identifier of the linked attribute term.

  - `productCategoryUuids` (array,null)
    Collection of product-category junction UUIDs. Populated when include[productCategories]=true.

  - `productCategories` (array,null)
    Collection of product-category junctions. Populated when expand[productCategories]=true.

  - `productCategories.uuid` (string, required)
    Unique identifier for this product-category association.

  - `productCategories.productUuid` (string, required)
    Identifier of the product this category is linked to.

  - `productCategories.categoryUuid` (string, required)
    Identifier of the linked category.

  - `productTagUuids` (array,null)
    Collection of product-tag junction UUIDs. Populated when include[productTags]=true.

  - `productTags` (array,null)
    Collection of product-tag junctions. Populated when expand[productTags]=true.

  - `productTags.uuid` (string, required)
    Unique identifier for this product-tag association.

  - `productTags.productUuid` (string, required)
    Identifier of the product this tag is linked to.

  - `productTags.tagUuid` (string, required)
    Identifier of the linked tag.

  - `contentUuids` (array,null)
    Collection of content UUIDs for this product.

  - `contents` (array,null)
    Collection of localized content for this product.

  - `contents.uuid` (string, required)
    Unique identifier for this content entry.

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

  - `contents.localeUuid` (string, required)
    Identifier of the locale for this content.

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

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

  - `contents.label` (string, required)
    Localized display label for the product.

  - `contents.description` (string,null)
    Localized detailed description for the product.

  - `contents.shortDescription` (string,null)
    Localized short description for the product.

  - `metadataUuids` (array,null)
    Collection of metadata UUIDs for this product.

  - `metadata` (array,null)
    Collection of custom metadata entries for this product.

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

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

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

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

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

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

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

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

  - `relationUuids` (array,null)
    Collection of relation UUIDs for this product.

  - `relations` (array,null)
    Collection of related products.

  - `relations.uuid` (string, required)
    Unique identifier for this product relation.

  - `relations.productUuid` (string, required)
    Identifier of the source product owning this relation.

  - `relations.productReferenceUuid` (string, required)
    Identifier of the target product being referenced.

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

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

  - `relations.productRelationTypeUuid` (string, required)
    Identifier of the product relation type.

  - `completeness` (object,null)
    Completeness evaluation data for a product.

  - `completeness.uuid` (string, required)
    Unique identifier for this completeness record.

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

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

  - `completeness.updatedAt` (string, required)
    Timestamp when this completeness record was last evaluated.
    Example: "2025-11-23T14:15:22.123456Z"

  - `completeness.overallScore` (integer, required)
    Overall completeness score from 0-100.

  - `completeness.canPublish` (boolean, required)
    Whether the product meets all required criteria for publishing.

  - `completeness.dimensionScores` (array,null)
    Collection of completeness scores broken down by dimension.

  - `completeness.dimensionScores.uuid` (string, required)
    Unique identifier for this dimension score.

  - `completeness.dimensionScores.productUuid` (string, required)
    Identifier of the product this score belongs to.

  - `completeness.dimensionScores.productCompletenessUuid` (string, required)
    Identifier of the parent completeness record.

  - `completeness.dimensionScores.createdAt` (string, required)
    Timestamp when this dimension score was created.
    Example: "2025-11-23T14:15:22.123456Z"

  - `completeness.dimensionScores.updatedAt` (string, required)
    Timestamp when this dimension score was last updated.
    Example: "2025-11-23T14:15:22.123456Z"

  - `completeness.dimensionScores.dimension` (string, required)
    The dimension being evaluated (Attributes, Categories, Assets, Relations, Sku).
    Enum: "attributes", "categories", "assets", "relations", "sku"

  - `completeness.dimensionScores.score` (integer, required)
    Completeness score for this dimension from 0-100.

  - `completeness.dimensionScores.totalRequiredCount` (integer, required)
    Total number of required items in this dimension.

  - `completeness.dimensionScores.totalOptionalCount` (integer, required)
    Total number of optional items in this dimension.

  - `completeness.dimensionScores.requiredSatisfiedCount` (integer, required)
    Number of required items that are satisfied.

  - `completeness.dimensionScores.requiredUnsatisfiedCount` (integer, required)
    Number of required items that are not satisfied.

  - `completeness.dimensionScores.optionalSatisfiedCount` (integer, required)
    Number of optional items that are satisfied.

  - `completeness.dimensionScores.optionalUnsatisfiedCount` (integer, required)
    Number of optional items that are not satisfied.

  - `completeness.dimensionScores.issues` (array,null)
    Collection of issues preventing full completeness in this dimension.

  - `completeness.dimensionScores.issues.uuid` (string, required)
    Unique identifier for this issue.

  - `completeness.dimensionScores.issues.productUuid` (string, required)
    Identifier of the product this issue belongs to.

  - `completeness.dimensionScores.issues.dimensionScoreUuid` (string, required)
    Identifier of the parent dimension score.

  - `completeness.dimensionScores.issues.itemUuid` (string,null)
    Identifier of the specific item causing the issue.

  - `completeness.dimensionScores.issues.createdAt` (string, required)
    Timestamp when this issue was identified.
    Example: "2025-11-23T14:15:22.123456Z"

  - `completeness.dimensionScores.issues.updatedAt` (string, required)
    Timestamp when this issue was last updated.
    Example: "2025-11-23T14:15:22.123456Z"

  - `completeness.dimensionScores.issues.type` (string, required)
    Type of issue (Missing, BelowMinimum, AboveMaximum, Forbidden, InvalidState).
    Enum: "missing", "belowMinimum", "aboveMaximum", "forbidden", "invalidState"

  - `completeness.dimensionScores.issues.itemType` (string, required)
    Type of item causing the issue (e.g., Attribute, Category).

  - `completeness.dimensionScores.issues.code` (string, required)
    Code of the item causing the issue.

  - `completeness.dimensionScores.issues.message` (string, required)
    Human-readable message describing the issue.

  - `completeness.dimensionScores.issues.isRequired` (boolean, required)
    Whether the issue is for a required item.

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