Skip to main content
GET
List disruption events

Authorizations

Authorization
string
header
required

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

country
string

ISO 3166-1 alpha-2 code. Only events in that country.

region
enum<string>

Only events in that region. Regions as supply-chain news is grouped, not the UN regions on distributors; to match a distributor or a part's origin, filter by country (an ISO 3166-1 alpha-2 code, as country_code on distributors and manufacturing_country_code on parts and BOM lines).

Available options:
Asia-Pacific,
Europe,
North America,
Middle East,
Latin America,
Africa,
Global
category
enum<string>

Only events affecting that component category.

Available options:
semiconductors,
electronics,
pcb,
connectors,
sensors,
motors,
drives,
power_supplies,
batteries,
cables_wire,
rf_microwave,
optics,
bearings,
mechanical,
hydraulics,
pneumatics,
seals_gaskets,
fluid_handling,
thermal,
industrial_automation,
filtration,
safety_equipment,
metals,
chemicals,
petrochemicals,
plastics,
raw_materials,
pharmaceuticals,
active_ingredients,
medical_devices,
agriculture,
fertilizers,
commodities,
automotive,
energy,
logistics
days
integer

Only events first recorded in the last N days, 1 to 90. Omit it for every active event.

Required range: 1 <= x <= 90
limit
integer
default:50

Events per page, 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page, unchanged. Omit it for the first page.

Response

The events. The list can be empty.

as_of
string<date-time>
required

ISO 8601. How current the data in this response is.

summary
string
required

Plain language an agent can relay without re-deriving it.

notice
string
required

Informational-use notice. Always present.

events
object[]
required

Newest first.

next_cursor
string | null
required

Pass as cursor for the next page. Null on the last page.