openapi: 3.0.3
info:
  title: AptarGroup Product Catalog Orders Products API
  description: API for the AptarGroup product catalog of dispensing, sealing, and active packaging solutions for the beauty, personal care, pharmaceutical, food, and home care markets. Enables partners to browse and integrate product data.
  version: 1.0.0
  contact:
    name: AptarGroup
    url: https://www.aptargroup.com
  license:
    name: Proprietary
servers:
- url: https://api.aptargroup.com/v1
  description: AptarGroup Product Catalog API
security:
- bearerAuth: []
tags:
- name: Products
  description: AptarGroup product catalog
paths:
  /products:
    get:
      operationId: listProducts
      summary: AptarGroup - List Products
      description: Returns a list of AptarGroup dispensing and packaging products
      tags:
      - Products
      parameters:
      - name: category
        in: query
        description: Filter by product category (dispensing, sealing, active-packaging)
        schema:
          type: string
      - name: market
        in: query
        description: Filter by target market (beauty, pharma, food, home-care)
        schema:
          type: string
      - name: sustainable
        in: query
        description: Filter to only sustainable products
        schema:
          type: boolean
      responses:
        '200':
          description: A list of products
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Product'
              examples:
                ListProductsExample:
                  x-microcks-default: true
                  summary: Example product list
                  value:
                    data:
                    - productId: APTAR-PUMP-001
                      name: EcoStar Airless Pump
                      category: dispensing
                      market: beauty
                      sustainable: true
        '401':
          description: Unauthorized - invalid or missing authentication token
  /products/{productId}:
    get:
      operationId: getProduct
      summary: AptarGroup - Get Product
      description: Returns details for a specific AptarGroup product
      tags:
      - Products
      parameters:
      - name: productId
        in: path
        required: true
        description: Unique product identifier
        schema:
          type: string
      responses:
        '200':
          description: Product details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Product'
              examples:
                GetProductExample:
                  x-microcks-default: true
                  summary: Example product detail
                  value:
                    productId: APTAR-PUMP-001
                    name: EcoStar Airless Pump
                    category: dispensing
                    market: beauty
                    description: Airless pump dispenser for skincare products
                    material: recycled-plastic
                    sustainable: true
                    sku: ECO-PUMP-50ML
        '404':
          description: Product not found
        '401':
          description: Unauthorized - invalid or missing authentication token
components:
  schemas:
    Product:
      title: Product
      description: An AptarGroup dispensing or packaging product
      type: object
      properties:
        productId:
          type: string
          description: Unique product identifier
        name:
          type: string
          description: Product name
        category:
          type: string
          description: Product category
        market:
          type: string
          description: Target market
        description:
          type: string
          description: Product description
        material:
          type: string
          description: Primary material
        sustainable:
          type: boolean
          description: Whether the product uses sustainable materials
        sku:
          type: string
          description: Stock keeping unit identifier
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT