Product

Complete enriched product model with current processing and moderation results

  • externalRef
    Type: string
    required
  • id
    Type: string Format: uuid
    required
  • images
    Type: array object[] · ProductImage[]
    required

    Public product image metadata. Private storage references are not returned.

    • id
      Type: string Format: uuid
      required
    • url
      Type: string Format: uri
      required
    • altText
      Type: string | null
    • isMatch
      Type: boolean
    • isPrimary
      Type: boolean
    • processStatus
      Type: string
    • variantId
      Type: string Format: uuid
  • inStock
    Type: boolean
    required
  • isPublished
    Type: boolean
    required
  • name
    Type: object
    required
    • propertyName
      Type: anything
  • price
    Type: object · Currency
    required

    Numeric price values keyed by uppercase ISO 4217 currency code

    • propertyName
      Type: number
  • processing
    Type: object · ProductProcessing
    required

    Progress for the catalogue's immutable feature-selected pipeline plan. Only stages in the compiled selected graph are returned; a returned stage can be skipped when runtime processing determines no work is needed. Moderation runs independently. Internal messages and traces are omitted.

    • completedStages
      Type: integer
      min:  
      0
      required

      Number of completed or skipped terminal stages.

    • currentStage
      Type: string | null enum
      required
      values
      • ingest
      • image_acquisition
      • image_indexing
      • semantic_text_indexing
      • ai_processing
      • identity_enrichment
      • dedup_indexing
      • deduplication
    • errors
      Type: array object[] · ProductProcessingError[]
      required

      Sanitized processing failures.

    • stages
      Type: array object[] · ProductProcessingStage[]
      required
    • totalStages
      Type: integer
      min:  
      0
      required

      Integer numbers.

  • processStatus
    Type: string enum
    required
    values
    • pending
    • processing
    • completed
    • partial
    • failed
  • sku
    Type: string
    required
  • url
    Type: string Format: uri
    required
  • versionHash
    Type: string
    required
  • attribute_slugs
    Type: object · ProductAttributeSlugs

    Resolved slug metadata by assigned category ID, then attribute key. The general bucket is used for uncategorized products.

    • propertyName
      Type: object
      • propertyName
        Type: object · ProductAttributeSlugMatch
        • attribute_slug
          Type: string
          min length:  
          1
          max length:  
          100

          Optional customer identifier. Spelling is preserved after trimming; duplicates are allowed.

        • attribute_value_slug
          Type: string
          min length:  
          1
          max length:  
          100

          Optional customer identifier. Spelling is preserved after trimming; duplicates are allowed.

  • attributes
    Type: object | null
    • propertyName
      Type: anything
  • brand
    Type: object · ProductBrandnullable
    • id
      Type: string Format: uuid
    • name
      Type: string
  • brandId
    Type: string | null Format: uuid
  • caption
    Type: string | null
  • categories
    Type: array
  • categoryDetails
    Type: array object[] · ProductCategoryDetail[]
    • id
      Type: string Format: uuid
      required
    • name
      Type: string
      required
    • parentId
      Type: string | null Format: uuid
      required
    • slug
      Type: string | null
      required
    • category_slug
      Type: string
      min length:  
      1
      max length:  
      100

      Optional customer identifier. Spelling is preserved after trimming; duplicates are allowed.

  • colour
    Type: object · ProductColournullable
    • primary
      Type: string
    • secondary
      Type: string | null
  • createdAt
    Type: string Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • customProperties
    Type: object
    read-only
    • propertyName
      Type: anything
  • deletedAt
    Type: string | null Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • description
    Type: object
    • propertyName
      Type: anything
  • dimensions
    Type: object · ProductDimensionsnullable
    • depth
      Type: number
    • depthCm
      Type: number
    • height
      Type: number
    • heightCm
      Type: number
    • length
      Type: number
    • unit
      Type: string
    • width
      Type: number
    • widthCm
      Type: number
  • ean
    Type: string | null
  • gtin
    Type: string | null
  • identifiers
    Type: array object[] · ProductIdentifier[]
    • type
      Type: string
      required
    • value
      Type: string
      required
  • keywords
    Type: array string[]
  • moderation
    Type: object · ProductModerationSummarynullable

    Current moderation aggregate and stage results for the active ruleset

    • stageResults
      Type: array object[] · ProductModerationStageResult[]
      required

      Current results for applicable moderation data stages. Only original, ai_enhanced, and images stages that apply are present; key entries by dataStage rather than array position.

      Current moderation outcome for one applicable data stage

    • imageUrl
      Type: string | null Format: uri
    • imageUrls
      Type: array string[] Format: uri
    • passedSlugs
      Type: array string[]
    • reviewStatus
      Type: string enum
      values
      • none
      • pending
      • approved
      • rejected
    • rulesetId
      Type: string Format: uuid
    • rulesetVersion
      Type: string | null
    • status
      Type: string enum

      Aggregate summary; inspect every stage result to determine completion

      values
      • pending
      • processing
      • approved
      • flagged
      • error
      • skipped
    • unpublishApplied
      Type: boolean
    • updatedAt
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • violations
      Type: array object[] · ModerationViolation[]
  • offers
    Type: array object[] · ProductOffer[]
    • externalRef
      Type: string | null
      required
    • id
      Type: string Format: uuid
      required
    • inStock
      Type: boolean
      required
    • isPublished
      Type: boolean
      required
    • price
      Type: object · Currency
      required

      Numeric price values keyed by uppercase ISO 4217 currency code

    • sku
      Type: string
      required
    • url
      Type: string Format: uri
      required
    • vendorAcceptedEnhancement
      Type: boolean | null
      required

      Vendor decision for Youzu's enhanced variant data. Null means no decision has been recorded, true means accepted, and false means explicitly declined.

    • vendorId
      Type: string Format: uuid
      required

      Vendor that supplied and owns this offer

    • versionHash
      Type: string
      required
    • condition
      Type: string enum
      values
      • new
      • like_new
      • open_box
      • refurbished
      • used
    • conditionNotes
      Type: object | null
    • createdAt
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • deletedAt
      Type: string | null Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • matchSource
      Type: string
    • originalAttributes
      Type: object
      read-only

      Latest unmodified attributes supplied for this offer

    • originalDescription
      Type: object

      Original localized description supplied by this offer's vendor

    • originalName
      Type: object

      Original localized name supplied by this offer's vendor

    • priceDiscount
      Type: object · Currencynullable

      Numeric price values keyed by uppercase ISO 4217 currency code

    • unpublishedByModeration
      Type: boolean
    • updatedAt
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • variantId
      Type: string Format: uuid
    • vendor
      Type: string
  • priceDiscount
    Type: object · Currencynullable

    Numeric price values keyed by uppercase ISO 4217 currency code

    • propertyName
      Type: number
  • productLabel
    Type: string | null
  • upc
    Type: string | null
  • updatedAt
    Type: string Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • variantAxes
    Type: array string[]
  • variants
    Type: array object[] · ProductVariant[]
    • id
      Type: string Format: uuid
      required
    • images
      Type: array object[] · ProductImage[]
      required

      Public product image metadata. Private storage references are not returned.

    • offers
      Type: array object[] · ProductOffer[]
      required
    • attribute_slugs
      Type: object · ProductAttributeSlugs

      Resolved slug metadata by assigned category ID, then attribute key. The general bucket is used for uncategorized products.

    • attributes
      Type: object | null

      Youzu-enhanced attributes for this variant

    • attributesTranslated
      Type: object | null
    • colour
      Type: object · ProductColournullable
    • createdAt
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • deletedAt
      Type: string | null Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • description
      Type: object

      Youzu-enhanced localized description for this variant

    • dimensions
      Type: object · ProductDimensionsnullable
    • ean
      Type: string | null
    • gtin
      Type: string | null
    • name
      Type: object

      Youzu-enhanced localized name for this variant

    • productId
      Type: string Format: uuid
    • upc
      Type: string | null
    • updatedAt
      Type: string Format: date-time

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • variantValues
      Type: object

      Dynamic configuration-axis values for this variant. Newly inferred keys and string values are lowercased, with keys normally using lower_snake_case (for example color, capacity, or pack_quantity). Existing stored keys and values are preserved, so clients must not assume a closed vocabulary.

    • weightKg
      Type: number | null
  • weight
    Type: number | null