Skip to content

Off-the-shelf Parts

Catalog parts identified by manufacturer and manufacturer part number.

Operations

Get Off-the-shelf Parts

Request

Look up multiple off-the-shelf parts by ID. Unresolved IDs are omitted rather than reported as errors.

Use GET /off-the-shelf-parts/{id} when requesting one part.

Security
BearerAuth
Headers
Acceptstring(OffTheShelfPartAcceptHeader)required

Set this to application/api.luminovo.off-the-shelf-part-v1+json.

Value:"application/api.luminovo.off-the-shelf-part-v1+json"
Bodyapplication/jsonrequired
idsArray of stringsrequired

IDs of the off-the-shelf parts to retrieve. Each ID must use the opaque OffTheShelf:<uuid> representation returned by this API.

Example:
[
  "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012"
]
curl -i -X POST \
  https://api.luminovo.com/off-the-shelf-parts/bulk \
  -H 'Accept: application/api.luminovo.off-the-shelf-part-v1+json' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
      "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012"
    ]
  }'

Responses

Successfully retrieved the off-the-shelf parts. IDs that cannot be resolved are omitted. Response order and multiplicity are not guaranteed to match the request; correlate items by ID.

Bodyapplication/json
itemsArray of objects(types.parts.off_the_shelf.v1.OffTheShelfPartResponse)required

Parts that were found. IDs that cannot be resolved are omitted.

Example:
[
  {
    "id": "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012",
    "manufacturer": { … },
    "mpn": "RC0402FR-0710KL",
    "mpn_aliases": [ … ],
    "description": "10 kOhm 1% 0402 resistor",
    "type": "Resistor",
    "categories": [ … ],
    "compliance": { … },
    "lifecycle": { … },
    "technical_properties": { … },
    "package": { … },
    "manufacturer_product_url": "https://example.com/products/RC0402FR-0710KL",
    "datasheet_url": "https://example.com/datasheets/RC0402FR-0710KL.pdf",
    "image_url": "https://example.com/images/RC0402FR-0710KL.jpg"
  }
]
Response
{
  "items": [
    { … }
  ]
}