Skip to content

Get Components by IPN

Request

Returns all components (including revisions) matching the given IPN value.

Each component includes:

  • internal_part_number: The IPN value and optional revision
  • type: "OffTheShelf" or "Custom"
  • risk_data: Aggregated compliance and lifecycle data derived from linked parts
  • linked_parts: Off-the-shelf parts (MPNs), generic specifications, or custom part specifications

If no component matches the given IPN value, the response contains an empty components array (not a 404 error), since one IPN value can map to multiple revisions.

Security
BearerAuth
Path
ipnstringrequired

The IPN (Internal Part Number) value to look up. Must be URL-encoded if it contains special characters (e.g., slashes, spaces).

Headers
Acceptstring(ComponentExportAcceptHeader)required

Set this to application/api.luminovo.component-v1+json.

Value:"application/api.luminovo.component-v1+json"
GET
/components/ipn/{ipn}
curl -i -X GET \
  'https://api.luminovo.com/components/ipn/{ipn}' \
  -H 'Accept: application/api.luminovo.component-v1+json' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Components matching the IPN value. Returns an empty list if no component with this IPN exists.

Bodyapplication/json
componentsArray of objects(types.ipn.v1.ExportedComponentResponse)required

List of components matching the requested IPN value, including all revisions.

Response
{
  "components": [
    { … }
  ]
}