Parts
Research a part
Supply-chain intelligence for one industrial part: a composite risk score with its four drivers, current distributor availability, a datasheet link, the live disruption events that touch it, alternate parts, and recommended actions.
A cold part takes tens of seconds because it gathers live data. The result is kept server-side for 48 hours, so repeat calls return quickly; responses themselves are not HTTP-cacheable and carry Cache-Control: no-store.
GET
/
v1
/
parts
Research a part
curl --request GET \
--url https://api.partfinder.dev/v1/parts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.partfinder.dev/v1/parts"
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/parts', 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/parts",
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/parts"
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/parts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.partfinder.dev/v1/parts")
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:19:19.099Z",
"summary": "STM32F103RBT6 carries a supply-chain risk score of 33 out of 100 (medium). Flagged: manufacturing geography (medium), lead-time volatility (critical). 348,529 units are held across 28 distributors.",
"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.",
"notes": [],
"part": {
"mpn": "STM32F103RBT6",
"manufacturer": "STMicroelectronics",
"category": "ARM Cortex-M3 MCU",
"lifecycle": "Active",
"manufacturing_country": "Malaysia",
"manufacturing_country_code": "MY"
},
"risk": {
"composite": {
"value": 33,
"scale": 100,
"direction": "higher_is_worse",
"interpretation": "Medium. Combined from manufacturing geography, lead-time volatility, live disruption exposure and how hard this part is to replace."
},
"tier": "medium",
"drivers": {
"geography": {
"tier": "medium",
"interpretation": "Medium. Reflects the risk profile of Malaysia."
},
"lead_time_volatility": {
"tier": "critical",
"interpretation": "Critical. Lead times for this part are highly unstable."
},
"disruption_exposure": {
"tier": "low",
"interpretation": "Low. Little exposure to active disruptions. 5 events and shipping conditions are listed in `disruption_events`."
},
"replacement_difficulty": {
"tier": "low",
"interpretation": "Low. Easy to source from several places."
}
},
"why_at_risk": "Made in Malaysia. 348,529 units in stock across 28 distributors. The middle half of quoted lead times runs 52 to 364 days. 5 disruptions and shipping conditions are listed for this part. No alternates are listed.",
"drivers_detail": [
{
"title": "Lead time",
"description": "The middle half of quoted lead times runs 52 to 364 days, with a median of 220 days."
},
{
"title": "Disruptions",
"description": "5 are listed for this part, including: Red Sea / Suez ship transits 54% below the usual level for this time of year; Wacker Chemie may close Tennessee polysilicon plant amid U.S. trade measures."
}
]
},
"supply": {
"stock": {
"value": 348529,
"unit": "units"
},
"lead_time_median": {
"value": 220,
"unit": "days"
},
"lead_time_min": {
"value": 52,
"unit": "days"
},
"lead_time_max": {
"value": 364,
"unit": "days"
},
"distributor_count": 28,
"distributors": [
{
"name": "Win Source",
"country": "United Kingdom",
"country_code": "GB",
"regions": [
"Europe"
],
"subregion": "Northern Europe",
"stock": {
"value": 91714,
"unit": "units"
}
},
{
"name": "Farnell",
"country": "United Kingdom",
"country_code": "GB",
"regions": [
"Europe"
],
"subregion": "Northern Europe",
"stock": {
"value": 63767,
"unit": "units"
}
}
],
"nearby": null
},
"datasheet": {
"url": "https://apexcomponent.com/wp-content/uploads/2026/05/STM32F103RBT6-STMicroelectronics-Datasheet.pdf",
"source": "other"
},
"disruption_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": 1178,
"title": "Chinese rare-earth firms withhold U.S. shipments amid Beijing pressure",
"root_cause": "geopolitical_action",
"country": "China",
"severity": "high",
"published_date": "2026-09-04T00:00:00.000Z",
"url": "https://www.usnews.com/news/top-news/articles/2026-09-04/china-rare-earth-firms-halt-some-us-shipments-over-geopolitical-worries-sources-say"
},
{
"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"
}
],
"alternates": [],
"recommended_actions": [
"For factory orders, allow for the 220-day median quoted lead time.",
"Monitor Red Sea / Suez ship transits 54% below the usual level for this time of year."
]
}{
"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": "credits_exhausted",
"summary": "Your organization's credits for this month are used up, so this request was not run. Upgrade your plan in the PartFinder console at https://console.partfinder.dev/settings/billing, then try again.",
"reason": "This request needs 20 credits and 0 are left.",
"billing_url": "https://console.partfinder.dev/settings/billing"
}{
"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>"
]
}{
"error": "authentication_required",
"summary": "<string>",
"reason": "<string>",
"billing_url": "<string>",
"did_you_mean": [
"<string>"
]
}Authorizations
An API key created in the PartFinder console at https://console.partfinder.dev, or a customer key created with POST /v1/keys. Send as Authorization: Bearer <key>. Revocation takes effect within approximately one minute.
Query Parameters
The manufacturer part number.
Only needed for a part number several manufacturers make, such as NE555N. Omit it otherwise — a bare part number is the normal case.
It narrows the supply figures to that manufacturer and, when known, the manufacturing origin to where that manufacturer makes the part, and with it the risk drivers that depend on where the part is made. A manufacturer that does not list the part returns a report with no supply data.
The buyer's country, as a two-letter ISO 3166-1 code. Adds supply.nearby: the distributors holding stock in that country, then elsewhere in its region. The risk score and every other field are the same with or without it.
Pattern:
^[A-Za-z]{2}$Response
The part report.
ISO 8601. How current the data in this response is.
Plain language an agent can relay without re-deriving it.
Informational-use notice. Always present.
Where supplier catalogues disagree with the manufacturer you passed for this part number. Empty when there is nothing to note.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
This part's risk on its own. A line in GET /v1/bom/{id} is scored within its BOM, with different drivers, so the same part can score differently on the two endpoints.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The reported events and current shipping conditions that most affect this part's disruption_exposure, strongest first: ordered by effect on this part's score, not by severity. Empty when none does.
Show child attributes
Show child attributes
Parts that could replace this one, up to five: the same list as GET /v1/alternates. Never this part itself or the same part in another package or ordering variant. Not ranked. Empty when none was found.
Show child attributes
Show child attributes
What a procurement team should do next.
Was this page helpful?
⌘I
Research a part
curl --request GET \
--url https://api.partfinder.dev/v1/parts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.partfinder.dev/v1/parts"
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/parts', 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/parts",
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/parts"
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/parts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.partfinder.dev/v1/parts")
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:19:19.099Z",
"summary": "STM32F103RBT6 carries a supply-chain risk score of 33 out of 100 (medium). Flagged: manufacturing geography (medium), lead-time volatility (critical). 348,529 units are held across 28 distributors.",
"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.",
"notes": [],
"part": {
"mpn": "STM32F103RBT6",
"manufacturer": "STMicroelectronics",
"category": "ARM Cortex-M3 MCU",
"lifecycle": "Active",
"manufacturing_country": "Malaysia",
"manufacturing_country_code": "MY"
},
"risk": {
"composite": {
"value": 33,
"scale": 100,
"direction": "higher_is_worse",
"interpretation": "Medium. Combined from manufacturing geography, lead-time volatility, live disruption exposure and how hard this part is to replace."
},
"tier": "medium",
"drivers": {
"geography": {
"tier": "medium",
"interpretation": "Medium. Reflects the risk profile of Malaysia."
},
"lead_time_volatility": {
"tier": "critical",
"interpretation": "Critical. Lead times for this part are highly unstable."
},
"disruption_exposure": {
"tier": "low",
"interpretation": "Low. Little exposure to active disruptions. 5 events and shipping conditions are listed in `disruption_events`."
},
"replacement_difficulty": {
"tier": "low",
"interpretation": "Low. Easy to source from several places."
}
},
"why_at_risk": "Made in Malaysia. 348,529 units in stock across 28 distributors. The middle half of quoted lead times runs 52 to 364 days. 5 disruptions and shipping conditions are listed for this part. No alternates are listed.",
"drivers_detail": [
{
"title": "Lead time",
"description": "The middle half of quoted lead times runs 52 to 364 days, with a median of 220 days."
},
{
"title": "Disruptions",
"description": "5 are listed for this part, including: Red Sea / Suez ship transits 54% below the usual level for this time of year; Wacker Chemie may close Tennessee polysilicon plant amid U.S. trade measures."
}
]
},
"supply": {
"stock": {
"value": 348529,
"unit": "units"
},
"lead_time_median": {
"value": 220,
"unit": "days"
},
"lead_time_min": {
"value": 52,
"unit": "days"
},
"lead_time_max": {
"value": 364,
"unit": "days"
},
"distributor_count": 28,
"distributors": [
{
"name": "Win Source",
"country": "United Kingdom",
"country_code": "GB",
"regions": [
"Europe"
],
"subregion": "Northern Europe",
"stock": {
"value": 91714,
"unit": "units"
}
},
{
"name": "Farnell",
"country": "United Kingdom",
"country_code": "GB",
"regions": [
"Europe"
],
"subregion": "Northern Europe",
"stock": {
"value": 63767,
"unit": "units"
}
}
],
"nearby": null
},
"datasheet": {
"url": "https://apexcomponent.com/wp-content/uploads/2026/05/STM32F103RBT6-STMicroelectronics-Datasheet.pdf",
"source": "other"
},
"disruption_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": 1178,
"title": "Chinese rare-earth firms withhold U.S. shipments amid Beijing pressure",
"root_cause": "geopolitical_action",
"country": "China",
"severity": "high",
"published_date": "2026-09-04T00:00:00.000Z",
"url": "https://www.usnews.com/news/top-news/articles/2026-09-04/china-rare-earth-firms-halt-some-us-shipments-over-geopolitical-worries-sources-say"
},
{
"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"
}
],
"alternates": [],
"recommended_actions": [
"For factory orders, allow for the 220-day median quoted lead time.",
"Monitor Red Sea / Suez ship transits 54% below the usual level for this time of year."
]
}{
"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": "credits_exhausted",
"summary": "Your organization's credits for this month are used up, so this request was not run. Upgrade your plan in the PartFinder console at https://console.partfinder.dev/settings/billing, then try again.",
"reason": "This request needs 20 credits and 0 are left.",
"billing_url": "https://console.partfinder.dev/settings/billing"
}{
"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>"
]
}{
"error": "authentication_required",
"summary": "<string>",
"reason": "<string>",
"billing_url": "<string>",
"did_you_mean": [
"<string>"
]
}