Renesas Product Part API

Endpoints for retrieving product parts.

OpenAPI Specification

renesas-product-part-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: Renesas Web Data Board & Kit Product Part 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.2.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.
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:
                    package:
                      packageCode: pkg_20001
                      href: /packages/pkg_20001
                    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-parts/attributes/field__display_1k_unit_price
                  - productPartAttributeId: field__group_name_linked_url
                    attributeValues:
                    - 'URL: https://www.renesas.com/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra2a1-32mhz-arm-cortex-m23-with-capacitive-touch-sensing-unit-low-power-microcontroller|RA2A1'
                    attributeName: Group Name
                    href: /product-parts/attributes/field__group_name_linked_url
                    attributeValuesParsed:
                    - type: URL
                      value: RA2A1
                      url: https://www.renesas.com/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ra2a1-32mhz-arm-cortex-m23-with-capacitive-touch-sensing-unit-low-power-microcontroller
                - 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:
                    package:
                      packageCode: pkg_20002
                      href: /packages/pkg_20002
                    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-parts/attributes/field__sel
                  - productPartAttributeId: field__supply_voltage_min
                    attributeValues:
                    - to: '7'
                      from: '7'
                    attributeName: Supply Voltage (min)
                    href: /product-parts/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:
                    package:
                      packageCode: pkg_9399
                      href: /packages/pkg_9399
                    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-parts/attributes/field__data_rate
                  - productPartAttributeId: field__display_1k_unit_price
                    attributeValues:
                    - 1.00163
                    attributeName: Price (USD)
                    href: /product-parts/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
                chipImage: https://www.renesas.com/sites/default/files/r5f571mgcdfb-chip.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:
                  package:
                    packageCode: pkg_9398
                    href: /packages/pkg_9398
                  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-parts/attributes/field__gpu
                - productPartAttributeId: field__i2c
                  attributeValues:
                  - '11'
                  attributeName: I2C
                  href: /product-parts/attributes/field__i2c
                - productPartAttributeId: field__bit_length
                  attributeValues:
                  - '32'
                  attributeName: Bit Length
                  href: /product-parts/attributes/field__bit_length
                - productPartAttributeId: field__supply_voltage_v
                  attributeValues:
                  - to: '3.6'
                    from: '2.7'
                  attributeName: Supply Voltage
                  href: /product-parts/attributes/field__supply_voltage_v
                - productPartAttributeId: field__display_1k_unit_price
                  attributeValues:
                  - 13.43121
                  attributeName: Price (USD)
                  href: /product-parts/attributes/field__display_1k_unit_price
                - productPartAttributeId: field__group_name_linked_url
                  attributeValues:
                  - 'URL: https://www.renesas.com/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/rx71m-high-performance-real-time-engine-32-bit-microcontrollers-industrial-equipment|RX71M'
                  attributeName: Group Name
                  href: /product-parts/attributes/field__group_name_linked_url
                  attributeValuesParsed:
                  - type: URL
                    value: RX71M
                    url: https://www.renesas.com/products/microcontrollers-microprocessors/rx-32-bit-performance-efficiency-mcus/rx71m-high-performance-real-time-engine-32-bit-microcontrollers-industrial-equipment
        '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
  /product-parts/search:
    post:
      tags:
      - Product Part
      security:
      - ApiKeyAuth: []
      summary: Parametric Search for Product Parts
      description: Search for product parts within a specific product using parametric attributes.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - productId
              properties:
                productId:
                  type: string
                  description: The product identifier to search within (required).
                  example: RA2A1
                limit:
                  type: integer
                  description: The number of results to return (default 10).
                  minimum: 1
                  maximum: 100
                  default: 10
                offset:
                  type: integer
                  description: The page number for pagination (default 0). This is multiplied by limit to get the actual offset.
                  minimum: 0
                  default: 0
                filters:
                  type: array
                  description: Array of parametric attribute filters.
                  items:
                    type: object
                    required:
                    - productPartAttributeId
                    properties:
                      productPartAttributeId:
                        type: string
                        description: The attribute identifier to filter by.
                        example: field__segment_lcd_controller
                      values:
                        type: array
                        description: Values to match (OR operation within this array).
                        items:
                          oneOf:
                          - type: string
                          - type: number
                          - type: boolean
                        example:
                        - 'Yes'
                        - Available
                      operator:
                        type: string
                        description: Comparison operator for numeric values.
                        enum:
                        - eq
                        - gt
                        - gte
                        - lt
                        - lte
                        - range
                        default: eq
                      min:
                        type: number
                        description: Minimum value for range operator.
                      max:
                        type: number
                        description: Maximum value for range operator.
            example:
              productId: RA2A1
              limit: 20
              offset: 0
              filters:
              - productPartAttributeId: field__operating_frequency
                operator: gte
                min: 48
              - productPartAttributeId: field__package_type
                values:
                - LQFP
                - QFN
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        orderableId:
                          type: string
                          description: Orderable product part identifier.
                        genericId:
                          type: string
                          description: Generic product identifier.
                        status:
                          type: string
                          description: Part status.
                        parametricAttributes:
                          type: array
                          description: Array of parametric attribute objects.
                          items:
                            type: object
                            properties:
                              productPartAttributeId:
                                type: string
                              attributeValues:
                                type: array
                                items:
                                  oneOf:
                                  - type: string
                                  - type: number
                                  - type: boolean
                                  - type: object
                              attributeName:
                                type: string
                              href:
                                type: string
                                format: uri
                        href:
                          type: string
                          format: uri
                          description: URL to the full product part details.
                  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 matching the search
                      has_more:
                        type: boolean
                        description: Whether there are more items available
                  filters:
                    type: object
                    description: The filters that were applied.
              example:
                data:
                - orderableId: R7FA2A1AB3CFM#AA0
                  genericId: RA2A1
                  status: Active
                  parametricAttributes:
                  - productPartAttributeId: field__operating_frequency
                    attributeValues:
                    - 48
                    attributeName: Operating Frequency (MHz)
                    href: /product-parts/attributes/field__operating_frequency
                  - productPartAttributeId: field__package_type
                    attributeValues:
                    - LQFP
                    attributeName: Package Type
                    href: /product-parts/attributes/field__package_type
                  - productPartAttributeId: field__pin_count
                    attributeValues:
                    - 48
                    attributeName: Pin Count
                    href: /product-parts/attributes/field__pin_count
                  - productPartAttributeId: field__flash_memory_kb
                    attributeValues:
                    - 256
                    attributeName: Flash Memory (KB)
                    href: /product-parts/attributes/field__flash_memory_kb
                  - productPartAttributeId: field__ram_kb
                    attributeValues:
                    - 32
                    attributeName: RAM (KB)
                    href: /product-parts/attributes/field__ram_kb
                  href: /product-parts/R7FA2A1AB3CFM%23AA0
                - orderableId: R7FA2A1AB3CFM#BA0
                  genericId: RA2A1
                  status: Active
                  parametricAttributes:
                  - productPartAttributeId: field__operating_frequency
                    attributeValues:
                    - 48
                    attributeName: Operating Frequency (MHz)
                    href: /product-parts/attributes/field__operating_frequency
                  - productPartAttributeId: field__package_type
                    attributeValues:
                    - LQFP
                    attributeName: Package Type
                    href: /product-parts/attributes/field__package_type
                  - productPartAttributeId: field__pin_count
                    attributeValues:
                    - 48
                    attributeName: Pin Count
                    href: /product-parts/attributes/field__pin_count
                  - productPartAttributeId: field__flash_memory_kb
                    attributeValues:
                    - 256
                    attributeName: Flash Memory (KB)
                    href: /product-parts/attributes/field__flash_memory_kb
                  - productPartAttributeId: field__ram_kb
                    attributeValues:
                    - 32
                    attributeName: RAM (KB)
                    href: /product-parts/attributes/field__ram_kb
                  href: /product-parts/R7FA2A1AB3CFM%23BA0
                - orderableId: R7FA2A1AB3CNF#AA0
                  genericId: RA2A1
                  status: Active
                  parametricAttributes:
                  - productPartAttributeId: field__operating_frequency
                    attributeValues:
                    - 48
                    attributeName: Operating Frequency (MHz)
                    href: /product-parts/attributes/field__operating_frequency
                  - productPartAttributeId: field__package_type
                    attributeValues:
                    - QFN
                    attributeName: Package Type
                    href: /product-parts/attributes/field__package_type
                  - productPartAttributeId: field__pin_count
                    attributeValues:
                    - 40
                    attributeName: Pin Count
                    href: /product-parts/attributes/field__pin_count
                  - productPartAttributeId: field__flash_memory_kb
                    attributeValues:
                    - 256
                    attributeName: Flash Memory (KB)
                    href: /product-parts/attributes/field__flash_memory_kb
                  - productPartAttributeId: field__ram_kb
                    attributeValues:
                    - 32
                    attributeName: RAM (KB)
                    href: /product-parts/attributes/field__ram_kb
                  href: /product-parts/R7FA2A1AB3CNF%23AA0
                pagination:
                  offset: 0
                  limit: 20
                  total: 7
                  has_more: false
                filters:
                  productId: RA2A1
                  applied:
                  - productPartAttributeId: field__operating_frequency
                    operator: gte
                    min: 48
                  - productPartAttributeId: field__package_type
                    values:
                    - LQFP
                    - QFN
        '400':
          description: Bad request - missing required productId or invalid filters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: productId is required
        '404':
          description: Product not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Product with ID 'RA2A1' not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              example:
                error: Failed to perform parametri

# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/renesas/refs/heads/main/openapi/renesas-product-part-api-openapi.yml