openapi: 3.0.0
info:
  title: Renesas Web Data API
  description: >
    The Renesas Web Data API enables external systems to retrieve product
    metadata in real time, without relying on manual CSV downloads or periodic
    feed refreshes. This shift improves data consistency, streamlines
    integrations, and aligns with modern API-first architectures.
  version: 1.0.0
servers:
  - url: https://api.renesas.com/web-data/v1
    description: Production Server
  - url: https://api.renesas-dev.com/web-data/v1
    description: Staging Server
security:
  - ApiKeyAuth: []
tags:
  - name: Product Part
    description: Endpoints for retrieving product parts.
  - name: Document
    description: Endpoint for retrieving documents.
  - name: Board & Kit
    description: Endpoints for retrieving boards and kits.
paths:
  /product-parts:
    get:
      tags:
        - Product Part
      security:
        - ApiKeyAuth: []
      summary: Get All Product Parts
      parameters:
        - name: limit
          in: query
          description: The number of results to return (default 10).
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
        - name: offset
          in: query
          description: >-
            The page number for pagination (default 0). This is multiplied by
            limit to get the actual offset.
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
        - name: order
          in: query
          description: >-
            Sorting property (default sort is by last updated date). Multiple
            sorts can be supplied by comma concatenation.
          required: false
          schema:
            type: string
            enum:
              - last_updated
              - part_number
              - part_status
              - 1ku_price
              - stock
            default: last_updated
          example: last_updated,part_number
        - name: orderDirection
          in: query
          description: >-
            Sorting direction (default is "desc"). Multiple directions can be
            defined for multiple sorts.
          required: false
          schema:
            type: string
            default: desc
          example: desc,asc
        - name: part_number_prefix
          in: query
          description: Filter by part number prefix.
          required: false
          schema:
            type: string
        - name: part_number
          in: query
          description: Filter by exact part number.
          required: false
          schema:
            type: string
        - name: part_status
          in: query
          description: Filter by part status.
          required: false
          schema:
            type: string
            enum:
              - Active
              - Preview
              - NRND
              - Not Recommended for New Designs
              - Not Recommended<br /> for New Designs
              - Obsolete
        - name: generic_product_id
          in: query
          description: Filter by generic product ID.
          required: false
          schema:
            type: string
        - name: product_family
          in: query
          description: Filter by product family.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/product_part'
                  pagination:
                    type: object
                    properties:
                      offset:
                        type: integer
                        description: The actual offset used (page * limit)
                      limit:
                        type: integer
                        description: The number of items per page
                      total:
                        type: integer
                        description: Total number of items available
                      has_more:
                        type: boolean
                        description: Whether there are more items available
              example:
                data:
                  - orderableId: ISL91302B40-EVZ
                    productCategory: ''
                    firstProductSubcategory: Multi-Channel Power Management ICs (PMICs)
                    genericId: ISL91302B40-EVZ
                    genericTitle: >-
                      ISL91302B Evaluation Board 1, 4+0 PMIC, WLCSP RoHS
                      Compliant
                    genericUrl: >-
                      https://www.renesas.com/en/design-resources/boards-kits/isl91302b40-evz
                    productFamily: ''
                    1kuPrice: 352.42
                    status: Active
                    type: ''
                    description: ''
                    class: ''
                    category: ''
                    leadCount: 0
                    dimensions:
                      length: 0
                      width: 0
                      thickness: 0
                      pitch: 0
                    peakReflowTemperature: ''
                    leadFree: true
                    partAvailability: false
                    featuredDocument:
                      title: ''
                      url: ''
                    images: ''
                    regulatory:
                      htsus: 8471.30.1180
                      eccn: EAR99
                      moistureSensitivityLevel: Not Applicable
                      rohsCompliant: ''
                      chinaRohsCompliant: ''
                      hazardousMaterials:
                        mercury: ''
                        lead: ''
                        halogen: ''
                        cadmium: ''
                        hexavalentChromium: ''
                        pbde: ''
                        pbb: ''
                    lifecycle: ''
                    alternative:
                      alternativeGenericId: ''
                      alternativeNote: ''
                    packaging:
                      carrierType: Board Pack
                      packageCode: ''
                      pbFreeCategory: None
                      jedecStandard: ''
                      quantityPerCarrier: ''
                      quantityPerReel: ''
                      reelSize: ''
                      tapePin1Quad: ''
                      tapePocketPitch: ''
                      packageUrl: ''
                      packageDescription: The ISL91302B40-EVZ platform allows quick evaluation...
                      packageName: ''
                      prevCode: ''
                    plp: ''
                    sampleable: true
                    replacementProduct: ''
                    replacementProductRemark: ''
                    parametricAttributes:
                      - productPartAttributeId: field__display_1k_unit_price
                        attributeValues:
                          - 352.42
                        attributeName: Price (USD)
                        href: /product-part-attributes/field__display_1k_unit_price
                  - orderableId: ISL71090SEHX50SAMPLE
                    productCategory: Space & Harsh Environment
                    firstProductSubcategory: Hi-Rel Voltage References
                    genericId: ISL71090SEH50
                    genericTitle: >-
                      Radiation Hardened Ultra Low Noise, Precision Voltage
                      Reference
                    genericUrl: https://www.renesas.com/en/products/isl71090seh50
                    productFamily: ''
                    1kuPrice: ''
                    status: Active
                    type: ''
                    description: ''
                    class: ''
                    category: ''
                    leadCount: 0
                    dimensions:
                      length: 0
                      width: 0
                      thickness: 0
                      pitch: 0
                    peakReflowTemperature: ''
                    leadFree: true
                    partAvailability: false
                    featuredDocument:
                      title: ''
                      url: ''
                    images:
                      - >-
                        https://www.renesas.com/sites/default/files/isl71090seh50_0.png
                    regulatory:
                      htsus: 8542.39.0090
                      eccn: 9A515.e.1
                      moistureSensitivityLevel: Not Applicable
                      rohsCompliant: ''
                      chinaRohsCompliant: ''
                      hazardousMaterials:
                        mercury: ''
                        lead: ''
                        halogen: ''
                        cadmium: ''
                        hexavalentChromium: ''
                        pbde: ''
                        pbb: ''
                    lifecycle: ''
                    alternative:
                      alternativeGenericId: ''
                      alternativeNote: ''
                    packaging:
                      carrierType: Die Waffle Pack
                      packageCode: ''
                      pbFreeCategory: Not Applicable
                      jedecStandard: ''
                      quantityPerCarrier: ''
                      quantityPerReel: ''
                      reelSize: ''
                      tapePin1Quad: ''
                      tapePocketPitch: ''
                      packageUrl: ''
                      packageDescription: The ISL71090SEH50 is an ultra low noise...
                      packageName: ''
                      prevCode: ''
                    plp: ''
                    sampleable: false
                    replacementProduct: ''
                    replacementProductRemark: ''
                    parametricAttributes:
                      - productPartAttributeId: field__sel
                        attributeValues:
                          - '86'
                        attributeName: DSEE (MeV·cm2/mg)
                        href: /product-part-attributes/field__sel
                      - productPartAttributeId: field__supply_voltage_min
                        attributeValues:
                          - to: '7'
                            from: '7'
                        attributeName: Supply Voltage (min)
                        href: /product-part-attributes/field__supply_voltage_min
                  - orderableId: RAA7881502GSP#AB0
                    productCategory: Interface
                    firstProductSubcategory: RS-485/422 with Enhanced ESD Protection
                    genericId: RAA788150
                    genericTitle: >-
                      5V Full-Duplex, 0.115Mbps RS-485/422 Differential
                      Transceiver with ±5kV EFT Immunity and ±10kV ESD
                      Protection
                    genericUrl: https://www.renesas.com/en/products/raa788150
                    productFamily: ''
                    1kuPrice: 1.00163
                    status: Active
                    type: SOICN
                    description: ''
                    class: ''
                    category: ''
                    leadCount: 14
                    dimensions:
                      length: 8.7
                      width: 3.9
                      thickness: 0
                      pitch: 1.3
                    peakReflowTemperature: ''
                    leadFree: true
                    partAvailability: true
                    featuredDocument:
                      title: ''
                      url: ''
                    images:
                      - >-
                        https://www.renesas.com/sites/default/files/RAA788150%20-%20Typical%20Operating%20Circuit%20for%20Full-Duplex%20Transceiver.PNG
                      - >-
                        https://www.renesas.com/sites/default/files/RAA788150%20-%20Block%20Diagram.PNG
                    regulatory:
                      htsus: ''
                      eccn: ''
                      moistureSensitivityLevel: '3'
                      rohsCompliant: ''
                      chinaRohsCompliant: ''
                      hazardousMaterials:
                        mercury: ''
                        lead: ''
                        halogen: ''
                        cadmium: ''
                        hexavalentChromium: ''
                        pbde: ''
                        pbb: ''
                    lifecycle: ''
                    alternative:
                      alternativeGenericId: ''
                      alternativeNote: ''
                    packaging:
                      carrierType: Tube
                      packageCode: MOR
                      pbFreeCategory: Pb-Free 100% Matte Tin Plate w/Anneal-e3
                      jedecStandard: ''
                      quantityPerCarrier: ''
                      quantityPerReel: ''
                      reelSize: ''
                      tapePin1Quad: ''
                      tapePocketPitch: ''
                      packageUrl: https://www.renesas.com/en/package/mor
                      packageDescription: >-
                        The RAA788150 5V full-duplex powered RS-485/RS-422
                        transceiver...
                      packageName: M14.15
                      prevCode: MOR
                    plp: ''
                    sampleable: true
                    replacementProduct: ''
                    replacementProductRemark: ''
                    parametricAttributes:
                      - productPartAttributeId: field__data_rate
                        attributeValues:
                          - '0.115'
                        attributeName: Data Rate (Mbps)
                        href: /product-part-attributes/field__data_rate
                      - productPartAttributeId: field__display_1k_unit_price
                        attributeValues:
                          - 1.00163
                        attributeName: Price (USD)
                        href: /product-part-attributes/field__display_1k_unit_price
                pagination:
                  offset: 0
                  limit: 3
                  total: 8973
                  has_more: true
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to retrieve parts list
  /product-parts/{orderable_id}:
    get:
      tags:
        - Product Part
      security:
        - ApiKeyAuth: []
      summary: Get Product Part by ID
      parameters:
        - name: orderable_id
          in: path
          schema:
            type: string
          required: true
          description: The unique identifier of the product part.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/product_part'
              example:
                orderableId: R5F571MGCDFB#10
                productCategory: Microcontrollers & Microprocessors
                firstProductSubcategory: RX 32-Bit Performance/Efficiency MCUs
                genericId: RX71M
                genericTitle: >-
                  High Performance Real-time Engine 32-bit Microcontrollers for
                  Industrial Equipment
                genericUrl: https://www.renesas.com/en/products/rx71m
                productFamily: RX
                1kuPrice: 13.43121
                status: Active
                type: LFQFP
                description: ''
                class: IC
                category: ''
                leadCount: 144
                dimensions:
                  length: 20
                  width: 20
                  thickness: 1.7
                  pitch: 0.5
                peakReflowTemperature: ''
                leadFree: true
                partAvailability: false
                featuredDocument:
                  title: ''
                  url: ''
                images:
                  - >-
                    https://www.renesas.com/sites/default/files/block-rx71m_0.png
                  - >-
                    https://www.renesas.com/sites/default/files/rx71m-pin-memory-image-item-d_0.png
                  - >-
                    https://www.renesas.com/sites/default/files/rx71m-pin-memory-image-item-g_0.png
                regulatory:
                  htsus: 8542.31.0025
                  eccn: 3A991.a.2
                  moistureSensitivityLevel: '3'
                  rohsCompliant: true
                  chinaRohsCompliant: true
                  hazardousMaterials:
                    mercury: true
                    lead: true
                    halogen: true
                    cadmium: true
                    hexavalentChromium: true
                    pbde: true
                    pbb: true
                lifecycle: e
                alternative:
                  alternativeGenericId: ''
                  alternativeNote: ''
                packaging:
                  carrierType: Full Carton (Tray)
                  packageCode: pkg_9398
                  pbFreeCategory: ''
                  jedecStandard: ''
                  quantityPerCarrier: ''
                  quantityPerReel: ''
                  reelSize: ''
                  tapePin1Quad: ''
                  tapePocketPitch: ''
                  packageUrl: https://www.renesas.com/en/package/pkg9398
                  packageDescription: 32-bit microcontroller capable of up to 240 MHz operation...
                  packageName: PLQP0144KA-A
                  prevCode: FP-144LV
                plp: 2039/12
                sampleable: false
                replacementProduct: ''
                replacementProductRemark: ''
                parametricAttributes:
                  - productPartAttributeId: field__gpu
                    attributeValues:
                      - 'No'
                    attributeName: 3D GPU
                    href: /product-part-attributes/field__gpu
                  - productPartAttributeId: field__i2c
                    attributeValues:
                      - '11'
                    attributeName: I2C
                    href: /product-part-attributes/field__i2c
                  - productPartAttributeId: field__bit_length
                    attributeValues:
                      - '32'
                    attributeName: Bit Length
                    href: /product-part-attributes/field__bit_length
                  - productPartAttributeId: field__supply_voltage_v
                    attributeValues:
                      - to: '3.6'
                        from: '2.7'
                    attributeName: Supply Voltage
                    href: /product-part-attributes/field__supply_voltage_v
                  - productPartAttributeId: field__display_1k_unit_price
                    attributeValues:
                      - 13.43121
                    attributeName: Price (USD)
                    href: /product-part-attributes/field__display_1k_unit_price
        '404':
          description: Product part not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Product part with ID 'INVALID123' not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to retrieve product part
  /documents:
    get:
      tags:
        - Document
      summary: Get All Documents
      parameters:
        - name: limit
          in: query
          description: The number of results to return (default 10).
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: offset
          in: query
          description: The offset for pagination.
          required: false
          schema:
            type: integer
            minimum: 0
        - name: language
          in: query
          description: Filter by document language (`en`, `ja`, `zh-hans`).
          required: false
          schema:
            type: string
            enum:
              - en
              - ja
              - zh-hans
        - name: dcpDocumentIdStartsWith
          in: query
          description: Filter by DCP Document ID prefix.
          required: false
          schema:
            type: string
        - name: productId
          in: query
          description: Filter by associated product ID.
          required: false
          schema:
            type: string
        - name: category
          in: query
          description: Filter by document category.
          required: false
          schema:
            type: string
        - name: documentRevisionDateStart
          in: query
          description: Filter by documents revised on or after this date (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: documentRevisionDateEnd
          in: query
          description: Filter by documents revised on or before this date (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/document'
  /documents/{dcp_id}:
    get:
      tags:
        - Document
      summary: Get Document by DCP Document ID
      parameters:
        - name: dcp_id
          in: path
          required: true
          description: The DCP document identifier.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/document'
  /documents/agile-id/{agile_id}:
    get:
      tags:
        - Document
      summary: Get Document by Agile ID
      parameters:
        - name: agile_id
          in: path
          required: true
          description: The Agile ID of the document.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/document'
  /boards-kits:
    get:
      tags:
        - Board & Kit
      security:
        - ApiKeyAuth: []
      summary: Get All Boards & Kits
      parameters:
        - name: limit
          in: query
          description: The number of results to return (default 10).
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
        - name: offset
          in: query
          description: >-
            The page number for pagination (default 0). This is multiplied by
            limit to get the actual offset.
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
        - name: order
          in: query
          description: >-
            Sorting property (default sort is by www update date). Multiple
            sorts can be supplied by comma concatenation.
          required: false
          schema:
            type: string
            enum:
              - wwwUpdateDate
              - title
              - boardKitType
            default: wwwUpdateDate
          example: wwwUpdateDate,title
        - name: orderDirection
          in: query
          description: >-
            Sorting direction (default is "desc"). Multiple directions can be
            defined for multiple sorts.
          required: false
          schema:
            type: string
            default: desc
          example: desc,asc
        - name: boardKitId
          in: query
          description: Filter by board/kit identifier.
          required: false
          schema:
            type: string
        - name: boardKitType
          in: query
          description: Filter by board/kit type.
          required: false
          schema:
            type: string
            enum:
              - development
              - evaluation
              - demonstration
              - reference
              - starter
        - name: category
          in: query
          description: Filter by product category.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/board_kit'
                  pagination:
                    type: object
                    properties:
                      offset:
                        type: integer
                        description: The actual offset used (page * limit)
                      limit:
                        type: integer
                        description: The number of items per page
                      total:
                        type: integer
                        description: Total number of items available
                      has_more:
                        type: boolean
                        description: Whether there are more items available
              example:
                data:
                  - boardKitId: RX71M
                    uuid: 5cdd14dc-21a8-4e9e-9d4d-4a83042b4e47
                    title: >-
                      High Performance Real-time Engine 32-bit Microcontrollers
                      for Industrial Equipment
                    boardKitType: evaluation
                    category:
                      - RX 32-Bit Performance/Efficiency MCUs
                    description: >-
                      32-bit microcontroller capable of up to 240 MHz operation.
                      Employs the RXv2 core, a more powerful evolved form of the
                      RX core that was used in previous RX devices, while
                      maintaining compatibility.
                    features: >-
                      On-board debugger, Arduino compatible headers, multiple
                      interface options
                    applications: Industrial automation, motor control, IoT applications
                    images:
                      - >-
                        https://www.renesas.com/sites/default/files/rx71m-evb-top.jpg
                      - >-
                        https://www.renesas.com/sites/default/files/rx71m-evb-bottom.jpg
                    orderableProducts:
                      - orderableId: R5F571MFCDFB#V0
                        href: >-
                          https://api.renesas.com/web-data/v1/product-parts/R5F571MFCDFB%23V0
                    partner:
                      - name: TESSERA Technology Inc.
                        url: https://www.tessera.co.jp/eng/
                  - boardKitId: S7G2-DK
                    uuid: 2b8f94ac-31d8-4e2e-8c3d-5b92053c5e48
                    title: Synergy S7G2 Development Kit
                    boardKitType: development
                    category:
                      - Synergy Platform
                    description: >-
                      Complete development kit for Synergy S7G2 microcontroller
                      with integrated development environment and rich
                      connectivity options
                    features: >-
                      Integrated development environment, rich connectivity
                      options
                    applications: IoT gateways, industrial HMI, connected appliances
                    images:
                      - >-
                        https://www.renesas.com/sites/default/files/s7g2-dk-main.jpg
                    orderableProducts:
                      - orderableId: S7G2DK
                        href: >-
                          https://api.renesas.com/web-data/v1/product-parts/S7G2DK
                    partner:
                      - name: TESSERA Technology Inc.
                        url: https://www.tessera.co.jp/eng/
                pagination:
                  offset: 0
                  limit: 10
                  total: 156
                  has_more: true
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to retrieve boards and kits list
  /boards-kits/{board_kit_id}:
    get:
      tags:
        - Board & Kit
      security:
        - ApiKeyAuth: []
      summary: Get Board or Kit by ID
      parameters:
        - name: board_kit_id
          in: path
          schema:
            type: string
          required: true
          description: The unique identifier of the board or kit.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/board_kit'
              example:
                boardKitId: RX71M
                uuid: 5cdd14dc-21a8-4e9e-9d4d-4a83042b4e47
                title: >-
                  High Performance Real-time Engine 32-bit Microcontrollers for
                  Industrial Equipment
                boardKitType: evaluation
                category:
                  - RX 32-Bit Performance/Efficiency MCUs
                description: >-
                  32-bit microcontroller capable of up to 240 MHz operation.
                  Employs the RXv2 core, a more powerful evolved form of the RX
                  core that was used in previous RX devices, while maintaining
                  compatibility. Realizes 1160 CoreMark, the top performance
                  among microcontrollers with built-in flash.
                features: >-
                  On-board debugger, Arduino compatible headers, multiple
                  interface options
                applications: Industrial automation, motor control, IoT applications
                additionalDetails: >-
                  The RX71M evaluation board provides a complete development
                  environment for evaluating and developing applications using
                  the RX71M microcontroller.
                images:
                  - >-
                    https://www.renesas.com/sites/default/files/rx71m-evb-top.jpg
                  - >-
                    https://www.renesas.com/sites/default/files/rx71m-evb-bottom.jpg
                orderableProducts:
                  - orderableId: R5F571MFCDFB#V0
                    href: >-
                      https://api.renesas.com/web-data/v1/product-parts/R5F571MFCDFB%23V0
                  - orderableId: R5F571MFCDFC#V0
                    href: >-
                      https://api.renesas.com/web-data/v1/product-parts/R5F571MFCDFC%23V0
                relatedBoardsKits:
                  - boardKitId: RX71M-Starter-Kit-Plus
                    title: Renesas Starter Kit+ for RX71M
                    href: >-
                      https://api.renesas.com/web-data/v1/boards-kits/RX71M-Starter-Kit-Plus
                  - boardKitId: YRPBRX71M
                    title: >-
                      RX71M Revelation Kit - Easy Evaluation and Development
                      with RX71M
                    href: https://api.renesas.com/web-data/v1/boards-kits/YRPBRX71M
                featuredDocuments:
                  - agileId: X0052700
                    dcpDocumentId: R01DS0249EJ0120
                    title: RX71M Datasheet Group Rev.1.20
                    type: Datasheet
                    language: en
                    href: >-
                      https://api.renesas.com/web-data/v1/documents/R01DS0249EJ0120
                relatedDocuments:
                  - agileId: X0052700
                    dcpDocumentId: R01DS0249EJ0120
                    title: RX71M Datasheet Group Rev.1.20
                    type: Datasheet
                    language: en
                    href: >-
                      https://api.renesas.com/web-data/v1/documents/R01DS0249EJ0120
                softwareTools:
                  - name: e2 studio
                    url: https://www.renesas.com/en/software-tool/e2-studio
                  - name: Renesas Flash Programmer (Programming GUI)
                    url: >-
                      https://www.renesas.com/en/software-tool/renesas-flash-programmer-programming-gui
                partner:
                  - name: TESSERA Technology Inc.
                    url: https://www.tessera.co.jp/eng/
        '404':
          description: Board or kit not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Board/kit with ID 'invalid-id' not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to retrieve board/kit details
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key required for authentication
  schemas:
    Product:
      $ref: '#/components/schemas/product'
    ProductPart:
      $ref: '#/components/schemas/product_part'
    ProductPartAttribute:
      $ref: '#/components/schemas/product_part_attribute'
    Document:
      $ref: '#/components/schemas/document'
    BoardKit:
      $ref: '#/components/schemas/board_kit'
    product_part:
      type: object
      properties:
        orderableId:
          type: string
          description: Unique identifier for the orderable product part.
        productCategory:
          type: string
          description: Category of the product.
        firstProductSubcategory:
          type: string
          description: First level subcategory of the product.
        genericId:
          type: string
          description: Generic identifier of the product part.
        genericTitle:
          type: string
          description: Generic title of the product part.
        genericUrl:
          type: string
          format: uri
          description: URL for the generic product part page.
        productFamily:
          type: string
          description: Family of the product.
        1kuPrice:
          type: number
          format: float
          nullable: true
          description: Price for 1K units of the product part.
        status:
          type: string
          enum:
            - Active
            - Obsolete
            - NRND
          description: Current status of the product part.
        type:
          type: string
          description: Type of the product part (e.g., IC, Module).
        description:
          type: string
          description: Description of the product part.
        class:
          type: string
          nullable: true
          description: Classification of the product part.
        category:
          type: string
          nullable: true
          description: Category of the product part.
        leadCount:
          type: integer
          minimum: 0
          description: Number of leads in the product part.
        dimensions:
          type: object
          properties:
            length:
              type: number
              format: float
              nullable: true
              description: Length of the product part.
            width:
              type: number
              format: float
              nullable: true
              description: Width of the product part.
            thickness:
              type: number
              format: float
              nullable: true
              description: Thickness of the product part.
            pitch:
              type: number
              format: float
              nullable: true
              description: Pitch of the product part.
        peakReflowTemperature:
          type: string
          nullable: true
          description: Peak reflow temperature for the product part.
        leadFree:
          type: boolean
          description: Indicates if the product part is lead-free.
        partAvailability:
          type: string
          description: Availability status of the product part.
        featuredDocument:
          type: object
          properties:
            documentTitle:
              type: string
              description: Title of the featured document.
            documentUrl:
              type: string
              format: uri
              description: URL of the featured document.
        images:
          type: array
          items:
            type: string
            format: uri
          description: List of image URLs.
        regulatory:
          type: object
          properties:
            htsus:
              type: string
              nullable: true
              description: HTSUS classification.
            eccn:
              type: string
              nullable: true
              description: ECCN classification.
            moistureSensitivityLevel:
              type: string
              nullable: true
              description: Moisture Sensitivity Level (MSL).
            rohsCompliant:
              type: boolean
              description: Indicates if the product part is RoHS compliant.
            chinaRohsCompliant:
              type: boolean
              description: Indicates if the product part complies with China RoHS.
            hazardousMaterials:
              type: object
              properties:
                mercury:
                  type: boolean
                lead:
                  type: boolean
                halogen:
                  type: boolean
                cadmium:
                  type: boolean
                hexavalentChromium:
                  type: boolean
                pbde:
                  type: boolean
                pbb:
                  type: boolean
        lifecycle:
          type: string
          description: Lifecycle status of the product part.
        alternative:
          type: object
          properties:
            alternativeGenericId:
              type: string
              nullable: true
              description: Alternative generic ID for the product part.
            alternativeNote:
              type: string
              nullable: true
              description: Additional notes on alternatives.
        packaging:
          type: object
          properties:
            carrierType:
              type: string
              description: Type of carrier (e.g., Tape & Reel, Tray).
            packageCode:
              type: string
              description: Package code.
            pbFreeCategory:
              type: string
              description: Pb-free category.
            jedecStandard:
              type: string
              description: JEDEC standard compliance.
            quantityPerCarrier:
              type: integer
              minimum: 0
              description: Quantity per carrier.
            quantityPerReel:
              type: integer
              minimum: 0
              nullable: true
              description: Quantity per reel.
            reelSize:
              type: string
              nullable: true
              description: Reel size information.
            tapePin1Quad:
              type: string
              nullable: true
              description: Tape pin 1 quadrant information.
            tapePocketPitch:
              type: number
              format: float
              nullable: true
              description: Tape pocket pitch measurement.
            packageUrl:
              type: string
              format: uri
              description: URL for packaging details.
            packageDescription:
              type: string
              description: Description of the packaging.
            packageName:
              type: string
              description: Name of the package.
            prevCode:
              type: string
              nullable: true
              description: Previous package code if applicable.
        plp:
          type: string
          nullable: true
          description: PLP termination information.
        sampleable:
          type: boolean
          description: Indicates if the product part is sampleable.
        replacementProduct:
          type: string
          nullable: true
          description: Replacement product identifier.
        replacementProductRemark:
          type: string
          nullable: true
          description: Remarks about the replacement product.
        parametricAttributes:
          type: array
          description: List of parametric attributes for the product part.
          items:
            type: object
            required:
              - productPartAttributeId
              - attributeName
              - href
              - attributeValues
            properties:
              productPartAttributeId:
                type: string
                description: Unique identifier for the product part attribute.
                example: field__segment_lcd_controller
              attributeName:
                type: string
                description: Name of the attribute.
                example: Segment LCD Controller
              href:
                type: string
                format: uri
                description: URL for the attribute.
                example: /product-part-attributes/field__segment_lcd_controller
              attributeValues:
                type: array
                description: List of values for the attribute.
                items:
                  oneOf:
                    - type: string
                      description: A single value for the attribute.
                    - type: number
                      format: float
                      description: A numeric value for the attribute.
                    - type: boolean
                      description: A boolean value for the attribute.
                example:
                  - Value1
                  - Value2
                  - 3.14
                  - true
    document:
      type: object
      properties:
        agileId:
          type: string
          description: Primary Agile ID of the document.
        dcpDocumentId:
          type: string
          description: DCP Document ID, if applicable.
        category:
          type: array
          description: Category.
          items:
            type: object
            properties:
              level:
                type: integer
                description: |
                  Level of the category:
                  * 1 - Primary category
                  * 2 - Secondary subcategory  
                  * 3 - Tertiary subcategory
                  * 4 - Fourth-level subcategory
                enum:
                  - 1
                  - 2
                  - 3
                  - 4
              title:
                type: string
                description: Title of the category.
            example:
              - level: 1
                title: Category Level 1
              - level: 2
                title: Category Level 2
        product:
          type: array
          description: List of associated products.
          items:
            type: object
            properties:
              productId:
                type: string
                description: Associated product ID.
              type:
                type: string
                description: Type of the associated product.
                enum:
                  - Product
                  - Board & Kit
                  - Software Tool
              title:
                type: string
                description: Associated product title.
              nid:
                type: string
                description: Drupal node ID of the product.
              uuid:
                type: string
                description: UUID of the product node.
              language:
                type: string
                description: Language code of the product node.
          example:
            - productId: RL78/G13
              title: Sample Product Title
              nid: 12345
              uuid: 550e8400-e29b-41d4-a716-446655440000
              language: en
        title:
          type: string
          description: Title of the document.
        type:
          type: string
          description: Type of the document (e.g., Flyer, App Note).
        fileType:
          type: string
          description: File format (e.g., PDF, DOCX).
        secureDocument:
          type: boolean
          description: Indicates if the document is secure or restricted.
        href:
          type: string
          format: uri
          description: Public URL of the document file.
        revisionDate:
          type: string
          description: Original revision date of the document.
        wwwUpdateDate:
          type: string
          description: Date the document was last updated on the website.
        language:
          type: string
          description: Language of the document (e.g., en, ja, zh-hans).
        nid:
          type: string
          description: Drupal node ID of the document.
        uuid:
          type: string
          description: UUID of the document node.
        translation:
          type: array
          description: List of translations for the document.
          items:
            type: object
            properties:
              language:
                type: string
                description: Language of the document (e.g., en, ja, zh).
              dcpDocumentId:
                type: string
                description: DCP Document ID of the translation.
              agileId:
                type: string
                description: Agile ID of the translation.
              title:
                type: string
                description: Title of the translation document.
              href:
                type: string
                format: uri
                description: URL to retrieve the translation document.
            example:
              - language: ja
                dcpDocumentId: DOC123456-JA
                agileId: X1234567
                href: /documents/DOC123456-JA
              - language: zh-hans
                dcpDocumentId: DOC123456-ZH
                agileId: X1234567
                title: Document Title in Chinese
                href: /documents/DOC123456-ZH
        published:
          type: boolean
          description: Publication status of the document.
        featured:
          type: boolean
          description: Whether the document is featured or highlighted.
        relationship:
          type: string
          description: Relationship or association type, if any.
        filename:
          type: string
          description: Original filename of the document.
        disclaimer:
          type: array
          description: List of associated disclaimer documents.
          items:
            type: object
            properties:
              dcpDocumentId:
                type: string
                description: DCP Document ID of the disclaimer document.
              agileId:
                type: string
                description: Agile ID of the disclaimer document.
              language:
                type: string
                description: Language of the document (e.g., en, ja, zh).
              title:
                type: string
                description: Title of the disclaimer document.
              href:
                type: string
                format: uri
                description: URL to retrieve the disclaimer document.
          example:
            - dcpDocumentId: DISC789012
              language: en
              agileId: X1234567
              title: Standard Product Disclaimer
              href: /documents/DISC789012
            - dcpDocumentId: DISC789013
              language: en
              agileId: X1234567
              title: Export Control Disclaimer
              href: /documents/DISC789013
        myrenesasDocument:
          type: boolean
          description: Is a MyRenesas document.
    board_kit:
      type: object
      properties:
        boardKitId:
          type: string
          description: Unique identifier for the board or kit.
          example: RX71M
        wwwUpdateDate:
          type: string
          description: Date the Board page was last updated on the website.
        uuid:
          type: string
          description: UUID of the board or kit.
          example: 5cdd14dc-21a8-4e9e-9d4d-4a83042b4e47
        title:
          type: string
          description: Title of the board or kit.
          example: >-
            High Performance Real-time Engine 32-bit Microcontrollers for
            Industrial Equipment
        boardKitType:
          type: string
          description: Type classification of the board or kit.
          enum:
            - development
            - evaluation
            - demonstration
            - reference
            - starter
          example: evaluation
        category:
          type: array
          nullable: true
          description: Parent product category.
          items:
            type: string
          example:
            - RX 32-Bit Performance/Efficiency MCUs
        description:
          type: string
          description: Detailed description of the board or kit.
          example: >-
            32-bit microcontroller capable of up to 240 MHz operation. Employs
            the RXv2 core, a more powerful evolved form of the RX core that was
            used in previous RX devices, while maintaining compatibility.
            Realizes 1160 CoreMark, the top performance among microcontrollers
            with built-in flash. Cache optimized for flash memory (AFU) can
            realize equivalent of 240-MHz zero wait flash memory access. The
            wait time for the CPU is a mere 1 cycle thanks to the 120-MHz zero
            wait access flash memory. This extremely high-speed memory access
            brings out the full performance of the CPU. Built-in AES, DES, SHA,
            and RNG protect data on a network. Built-in trusted memory function
            forbids reading of code from a specified area of the built-in flash
            memory. Equipped with up to 4 MB of code ROM and 552 KB of work RAM
            to support the increasing code/work area demanded by IoT network
            control and other applications.
        features:
          type: string
          description: Key features and capabilities of the board or kit.
          example: >-
            On-board debugger, Arduino compatible headers, multiple interface
            options
        applications:
          type: string
          description: Target applications and use cases.
          example: Industrial automation, motor control, IoT applications
        additionalDetails:
          type: string
          nullable: true
          description: Additional technical details and specifications.
        images:
          type: array
          description: Array of image URLs for the board or kit.
          items:
            type: string
            format: uri
          example:
            - https://www.renesas.com/sites/default/files/rx71m-evb-top.jpg
            - https://www.renesas.com/sites/default/files/rx71m-evb-bottom.jpg
        orderableProducts:
          type: array
          description: List of orderable product parts associated with this board/kit.
          items:
            type: object
            properties:
              orderableId:
                type: string
                description: Orderable product part identifier.
              href:
                type: string
                format: uri
                description: URL to the product part endpoint.
          example:
            - orderableId: R5F571MFCDFB#V0
              href: >-
                https://api.renesas.com/web-data/v1/product-parts/R5F571MGCDFB%2310
            - orderableId: R5F571MFCDFC#V0
              href: >-
                https://api.renesas.com/web-data/v1/product-parts/R5F571MGCDFB%2330
        relatedBoardsKits:
          type: array
          description: List of related product identifiers.
          items:
            type: object
            properties:
              boardKitId:
                type: string
                description: Related board or kit identifier.
              title:
                type: string
                description: Title of the related board or kit.
              href:
                type: string
                format: uri
                description: URL to the board/kit endpoint.
          example:
            - boardKitId: RX71M-Starter-Kit-Plus
              title: Renesas Starter Kit+ for RX71M
              href: >-
                https://api.renesas.com/web-data/v1/boards-kits/RX71M-Starter-Kit-Plus
            - boardKitId: YRPBRX71M
              title: >-
                RX71M Revelation Kit - Easy Evaluation and Development with
                RX71M
              href: https://api.renesas.com/web-data/v1/boards-kits/YRPBRX71M
        featuredDocuments:
          type: array
          description: Featured documents associated with the board/kit.
          items:
            type: object
            properties:
              agileId:
                type: string
                description: Agile ID of the document.
              dcpDocumentId:
                type: string
                nullable: true
                description: DCP Document ID, if applicable.
              title:
                type: string
                description: Document title.
              type:
                type: string
                description: Document type.
              language:
                type: string
                description: Document language.
              href:
                type: string
                format: uri
                description: Public URL of the document file.
          example:
            - agileId: X0052700
              dcpDocumentId: R01DS0249EJ0120
              title: RX71M Datasheet Group Rev.1.20
              type: Datasheet
              language: en
              href: https://api.renesas.com/web-data/v1/documents/R01DS0249EJ0120
        relatedDocuments:
          type: array
          description: List of related document identifiers.
          items:
            type: object
            properties:
              agileId:
                type: string
                description: Agile ID of the document.
              dcpDocumentId:
                type: string
                nullable: true
                description: DCP Document ID, if applicable.
              title:
                type: string
                description: Document title.
              type:
                type: string
                description: Document type.
              language:
                type: string
                description: Document language.
              href:
                type: string
                format: uri
                description: Public URL of the document file.
          example:
            - agileId: X0052700
              dcpDocumentId: R01DS0249EJ0120
              title: RX71M Datasheet Group Rev.1.20
              type: Datasheet
              language: en
              href: https://api.renesas.com/web-data/v1/documents/R01DS0249EJ0120
        softwareTools:
          type: array
          description: Compatible software tools and development environments.
          items:
            type: object
            properties:
              name:
                type: string
              url:
                type: string
                format: uri
                nullable: true
          example:
            - name: e2 studio
              url: https://www.renesas.com/en/software-tool/e2-studio
            - name: Renesas Flash Programmer (Programming GUI)
              url: >-
                https://www.renesas.com/en/software-tool/renesas-flash-programmer-programming-gui
        partner:
          type: array
          nullable: true
          description: Partner information if applicable.
          items:
            type: object
            properties:
              name:
                type: string
                description: Partner company name.
              url:
                type: string
                format: uri
                nullable: true
                description: Partner website URL.
          example:
            - name: TESSERA Technology Inc.
              url: https://www.tessera.co.jp/eng/
    product:
      type: object
      properties:
        productId:
          type: string
          description: Unique identifier for the product.
        pageTitle:
          type: string
          description: Title of the product page.
        metaDescription:
          type: string
          description: Meta description for SEO purposes.
        metaKeyword:
          type: string
          description: Meta keywords for SEO purposes.
        overview:
          type: string
          description: Brief overview of the product.
        features:
          type: string
          description: Key features of the product.
        specifications:
          type: string
          description: Technical specifications of the product.
        additionalDetails:
          type: string
          description: Additional details about the product.
        applications:
          type: string
          description: Applications and use cases for the product.
        images:
          type: array
          items:
            type: string
            format: uri
          description: List of image URLs for the product.
    product_part_attribute:
      type: object
      required:
        - productPartAttributeId
      properties:
        productPartAttributeId:
          type: string
          description: Unique identifier for the product part attribute.
