---
title: "Parametric Search for Product Parts"
method: POST
path: "/product-parts/search"
tags: ["Product Part"]
---

# Parametric Search for Product Parts

`POST /product-parts/search`

## Request

- Base URL: `https://api.renesas.com/web-data/v1`
- URL: `https://api.renesas.com/web-data/v1/product-parts/search`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/renesas/apis/renesas-web-data-api/docs/product-parts/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Search for product parts within a specific product using parametric attributes.

## Request body

- object
  - `productId` string, required: The product identifier to search within (required).
  - `limit` integer: The number of results to return (default 10).
  - `offset` integer: The page number for pagination (default 0). This is multiplied by limit to get the actual offset.
  - `filters` object[]: Array of parametric attribute filters.
    - `productPartAttributeId` string, required: The attribute identifier to filter by.
    - `values` union[]: Values to match (OR operation within this array).
      - union
        - string
        - number
        - boolean
    - `operator` 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'range': Comparison operator for numeric values.
    - `min` number: Minimum value for range operator.
    - `max` number: Maximum value for range operator.

## Response `200`

Successful response

- object
  - `data` object[]
    - `orderableId` string: Orderable product part identifier.
    - `genericId` string: Generic product identifier.
    - `status` string: Part status.
    - `parametricAttributes` object[]: Array of parametric attribute objects.
      - `productPartAttributeId` string
      - `attributeValues` union[]
        - union
          - string
          - number
          - boolean
          - object
      - `attributeName` string
      - `href` string, uri
    - `href` string, uri: URL to the full product part details.
  - `pagination` object
    - `offset` integer: The actual offset used (page * limit)
    - `limit` integer: The number of items per page
    - `total` integer: Total number of items matching the search
    - `has_more` boolean: Whether there are more items available
  - `filters` object: The filters that were applied.

## Other responses

- `400`: Bad request - missing required productId or invalid filters
- `404`: Product not found
- `500`: Internal server error

---

[API](https://skmtc.dev/renesas/apis/renesas-web-data-api.md) - [All operations](https://skmtc.dev/renesas/apis/renesas-web-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/renesas/apis/renesas-web-data-api/revisions/4a72e6c49b2c?raw)