Get a BOM report

curl --request GET \
  --url https://api.partfinder.dev/v1/bom/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.partfinder.dev/v1/bom/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.partfinder.dev/v1/bom/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.partfinder.dev/v1/bom/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.partfinder.dev/v1/bom/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.partfinder.dev/v1/bom/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.partfinder.dev/v1/bom/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "as_of": "2026-10-01T12:45:25.731Z",
  "summary": "3 lines: 0 critical, 0 high, 2 medium, 0 low, 1 not scored. Flagged at medium or above: geography on 3 lines, disruption exposure on 1 line, lead-time volatility on 2 lines.",
  "notice": "Informational only. Risk scores, stock levels, lead times and alternate-part suggestions may be incomplete, delayed or inaccurate. Independently verify before making procurement, engineering, compliance, safety or sourcing decisions.",
  "bom": {
    "id": "fc2b3371-7eb7-48cd-8847-70b2d76b0be8",
    "name": "Controller board rev C",
    "status": "complete",
    "lines": 3,
    "created_at": "2026-09-28T15:49:38.809Z",
    "completed_at": "2026-09-28T15:50:00.022Z",
    "identified": 3,
    "unresolved": 0
  },
  "scored_for_country": null,
  "risk": {
    "average": {
      "value": 29,
      "scale": 100,
      "direction": "higher_is_worse",
      "interpretation": "Medium. The mean of the 2 scored lines."
    },
    "distribution": {
      "critical": 0,
      "high": 0,
      "medium": 2,
      "low": 0,
      "not_scored": 1
    },
    "gaps": [
      {
        "kind": "no_supplier",
        "lines": 2,
        "interpretation": "2 lines name no supplier. A data gap; it counts in the gaps driver."
      }
    ]
  },
  "countries": [
    {
      "country": "Mexico",
      "country_code": "MX",
      "lines": 1,
      "share_percent": 33.3,
      "worst_tier": "medium"
    },
    {
      "country": "Malaysia",
      "country_code": "MY",
      "lines": 1,
      "share_percent": 33.3,
      "worst_tier": "medium"
    },
    {
      "country": "China",
      "country_code": "CN",
      "lines": 1,
      "share_percent": 33.3,
      "worst_tier": null
    }
  ],
  "parts": [
    {
      "line": 1,
      "mpn": "TPS54331DR",
      "manufacturer": "Texas Instruments",
      "quantity": 100,
      "status": "resolved",
      "notes": [],
      "part": {
        "identified_mpn": null,
        "category": "Semiconductors",
        "lifecycle": "Active",
        "manufacturing_country": "Mexico",
        "manufacturing_country_code": "MX"
      },
      "risk": {
        "composite": {
          "value": 31,
          "scale": 100,
          "direction": "higher_is_worse",
          "interpretation": "Medium. Combined from manufacturing geography, disruption exposure, lead-time volatility and sourcing gaps."
        },
        "tier": "medium",
        "drivers": {
          "geography": {
            "tier": "high",
            "interpretation": "High. Reflects the risk profile of Mexico."
          },
          "disruption_exposure": {
            "tier": "medium",
            "interpretation": "Medium. Some exposure to active disruptions. 5 events and shipping conditions are listed in `events`."
          },
          "lead_time_volatility": {
            "tier": "medium",
            "interpretation": "Medium. Lead times for this part vary somewhat."
          },
          "gaps": {
            "tier": "low",
            "interpretation": "Low. No sourcing gap flagged for this line."
          }
        },
        "gap_flags": [],
        "events": [
          {
            "kind": "port_activity",
            "id": null,
            "title": "Ports in Mexico: ship arrivals 21% below the usual level for this time of year",
            "root_cause": null,
            "country": "Mexico",
            "severity": null,
            "published_date": "2026-09-18T00:00:00.000Z",
            "url": null
          },
          {
            "kind": "news",
            "id": 1179,
            "title": "Wacker Chemie may close Tennessee polysilicon plant amid U.S. trade measures",
            "root_cause": "geopolitical_action",
            "country": "United States",
            "severity": "high",
            "published_date": "2026-09-04T00:00:00.000Z",
            "url": "https://www.reuters.com/business/trumps-bid-shield-chip-supply-chain-could-backfire-tennessee-2026-09-04/"
          },
          {
            "kind": "sea_route",
            "id": null,
            "title": "Panama Canal: ship transits 21% below the usual level for this time of year",
            "root_cause": null,
            "country": null,
            "severity": null,
            "published_date": "2026-09-20T00:00:00.000Z",
            "url": null
          },
          {
            "kind": "news",
            "id": 1189,
            "title": "China imposes provisional duties on Japanese semiconductor chemical",
            "root_cause": "regulatory_change",
            "country": "China",
            "severity": "medium",
            "published_date": "2026-09-09T00:00:00.000Z",
            "url": "https://hk.epochtimes.com/news/2026-09-09/80403878"
          },
          {
            "kind": "news",
            "id": 1166,
            "title": "China imposes helium export controls affecting global high‑tech supply",
            "root_cause": "regulatory_change",
            "country": "China",
            "severity": "high",
            "published_date": "2026-07-11T00:00:00.000Z",
            "url": "https://www.caixinglobal.com/2026-07-11/china-bans-helium-exports-as-global-supply-crunch-hits-chipmaking-gas-102462943.html"
          }
        ]
      },
      "supply": {
        "stock": {
          "value": 9215,
          "unit": "units"
        },
        "lead_time_median": {
          "value": 94,
          "unit": "days"
        },
        "lead_time_min": {
          "value": 84,
          "unit": "days"
        },
        "lead_time_max": {
          "value": 106,
          "unit": "days"
        },
        "distributor_count": 2,
        "scope": "manufacturer",
        "distributors": [
          {
            "name": "Mouser",
            "country": "United States",
            "country_code": "US",
            "regions": [
              "Americas"
            ],
            "subregion": "Northern America",
            "stock": {
              "value": 5941,
              "unit": "units"
            }
          },
          {
            "name": "Farnell",
            "country": "United Kingdom",
            "country_code": "GB",
            "regions": [
              "Europe"
            ],
            "subregion": "Northern Europe",
            "stock": {
              "value": 3274,
              "unit": "units"
            }
          }
        ]
      }
    },
    {
      "line": 2,
      "mpn": "STM32F407VGT6",
      "manufacturer": "STMicroelectronics",
      "quantity": 50,
      "status": "resolved",
      "notes": [],
      "part": {
        "identified_mpn": null,
        "category": "Semiconductors",
        "lifecycle": "Active",
        "manufacturing_country": "Malaysia",
        "manufacturing_country_code": "MY"
      },
      "risk": {
        "composite": {
          "value": 26,
          "scale": 100,
          "direction": "higher_is_worse",
          "interpretation": "Medium. Combined from manufacturing geography, disruption exposure, lead-time volatility and sourcing gaps."
        },
        "tier": "medium",
        "drivers": {
          "geography": {
            "tier": "medium",
            "interpretation": "Medium. Reflects the risk profile of Malaysia."
          },
          "disruption_exposure": {
            "tier": "low",
            "interpretation": "Low. Little exposure to active disruptions. 4 events and shipping conditions are listed in `events`."
          },
          "lead_time_volatility": {
            "tier": "high",
            "interpretation": "High. Lead times for this part vary a lot."
          },
          "gaps": {
            "tier": "low",
            "interpretation": "Low. Sourcing gaps on this line: no supplier named."
          }
        },
        "gap_flags": [
          "no_supplier"
        ],
        "events": [
          {
            "kind": "sea_route",
            "id": null,
            "title": "Red Sea / Suez: ship transits 54% below the usual level for this time of year",
            "root_cause": null,
            "country": null,
            "severity": null,
            "published_date": "2026-09-20T00:00:00.000Z",
            "url": null
          },
          {
            "kind": "news",
            "id": 1179,
            "title": "Wacker Chemie may close Tennessee polysilicon plant amid U.S. trade measures",
            "root_cause": "geopolitical_action",
            "country": "United States",
            "severity": "high",
            "published_date": "2026-09-04T00:00:00.000Z",
            "url": "https://www.reuters.com/business/trumps-bid-shield-chip-supply-chain-could-backfire-tennessee-2026-09-04/"
          },
          {
            "kind": "news",
            "id": 1189,
            "title": "China imposes provisional duties on Japanese semiconductor chemical",
            "root_cause": "regulatory_change",
            "country": "China",
            "severity": "medium",
            "published_date": "2026-09-09T00:00:00.000Z",
            "url": "https://hk.epochtimes.com/news/2026-09-09/80403878"
          },
          {
            "kind": "news",
            "id": 1166,
            "title": "China imposes helium export controls affecting global high‑tech supply",
            "root_cause": "regulatory_change",
            "country": "China",
            "severity": "high",
            "published_date": "2026-07-11T00:00:00.000Z",
            "url": "https://www.caixinglobal.com/2026-07-11/china-bans-helium-exports-as-global-supply-crunch-hits-chipmaking-gas-102462943.html"
          }
        ]
      },
      "supply": {
        "stock": {
          "value": 24453,
          "unit": "units"
        },
        "lead_time_median": {
          "value": 369,
          "unit": "days"
        },
        "lead_time_min": {
          "value": 220,
          "unit": "days"
        },
        "lead_time_max": {
          "value": 373,
          "unit": "days"
        },
        "distributor_count": 4,
        "scope": "manufacturer",
        "distributors": [
          {
            "name": "Farnell",
            "country": "United Kingdom",
            "country_code": "GB",
            "regions": [
              "Europe"
            ],
            "subregion": "Northern Europe",
            "stock": {
              "value": 21050,
              "unit": "units"
            }
          },
          {
            "name": "element14",
            "country": "Singapore",
            "country_code": "SG",
            "regions": [
              "Asia"
            ],
            "subregion": "South-eastern Asia",
            "stock": {
              "value": 3174,
              "unit": "units"
            }
          }
        ]
      }
    },
    {
      "line": 3,
      "mpn": "6305-2RS",
      "manufacturer": "SKF",
      "quantity": 10,
      "status": "resolved",
      "notes": [],
      "part": {
        "identified_mpn": null,
        "category": "Bearings & Linear Guides",
        "lifecycle": null,
        "manufacturing_country": "China",
        "manufacturing_country_code": "CN"
      },
      "risk": {
        "composite": null,
        "tier": null,
        "reason": "No distributor has stock or lead-time figures for this line, so no overall score is computed.",
        "drivers": {
          "geography": {
            "tier": "medium",
            "interpretation": "Medium. Reflects the risk profile of China."
          },
          "disruption_exposure": {
            "tier": "low",
            "interpretation": "Low. Little exposure to active disruptions. 1 event or shipping condition is listed in `events`."
          },
          "lead_time_volatility": null,
          "gaps": {
            "tier": "low",
            "interpretation": "Low. Sourcing gaps on this line: no supplier named."
          }
        },
        "gap_flags": [
          "no_supplier"
        ],
        "events": [
          {
            "kind": "sea_route",
            "id": null,
            "title": "Red Sea / Suez: ship transits 54% below the usual level for this time of year",
            "root_cause": null,
            "country": null,
            "severity": null,
            "published_date": "2026-09-20T00:00:00.000Z",
            "url": null
          }
        ]
      },
      "supply": {
        "stock": {
          "value": null,
          "unit": "units",
          "reason": "No distributor data available for this line."
        },
        "lead_time_median": {
          "value": null,
          "unit": "days",
          "reason": "No distributor quotes a lead time for this line."
        },
        "lead_time_min": {
          "value": null,
          "unit": "days",
          "reason": "No distributor quotes a lead time."
        },
        "lead_time_max": {
          "value": null,
          "unit": "days",
          "reason": "No distributor quotes a lead time."
        },
        "distributor_count": 0,
        "scope": null,
        "distributors": []
      }
    }
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}

{
  "error": "authentication_required",
  "summary": "<string>",
  "reason": "<string>",
  "billing_url": "<string>",
  "did_you_mean": [
    "<string>"
  ]
}