bd.com APIbd.com ↗
Access structured BD medical device recall notices and safety alerts via API. Returns campaign IDs, catalog numbers, lot info, clinical impact, and status.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/a4226e92-0368-4e88-a7f2-fbefc08744a9/get_recalls' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch all active recall notices and safety alerts published by BD. Returns metadata, clinical impact assessments, and product identifiers such as catalog numbers and lot information.
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer total number of recalls returned",
"recalls": "array of recall objects with id, campaign_id, product_name, start_date, status, description_html, extracted_catalog_numbers, extracted_lot_info"
},
"sample": {
"data": {
"count": 29,
"recalls": [
{
"id": "701Ho0000016qy0IAA",
"status": "Active",
"start_date": "2026-01-12",
"campaign_id": "PI-26-06013",
"product_name": "Hickman™ and Broviac™ Central Venous Catheters",
"description_html": "<p>BD has identified via internal inspections that...</p>",
"extracted_lot_info": [],
"extracted_catalog_numbers": []
}
]
},
"status": "success"
}
}About the bd.com API
The BD Recalls API exposes 1 endpoint — get_recalls — that returns all active recall notices and safety alerts published by Becton, Dickinson and Company. Each record includes up to 8 structured fields: a unique recall ID, campaign identifier, product name, start date, status, HTML-formatted clinical description, extracted catalog numbers, and supplementary metadata. This gives developers a machine-readable view of BD's public safety communications without manual parsing.
What the API Returns
The get_recalls endpoint returns the full set of active recall notices and safety alerts from BD's official recall listings. The response envelope includes a count integer indicating how many recall objects were returned, plus a recalls array where each item carries a unique id, a campaign_id linking related records to a single recall campaign, the product_name, the start_date of the recall, and a status field indicating whether the recall is ongoing or resolved.
Clinical and Product Detail Fields
Each recall object also contains a description_html field with the full clinical impact summary and recommended user actions as HTML — suitable for rendering in a portal or stripping to plain text for downstream processing. The extracted_catalog_numbers field surfaces structured catalog and lot number identifiers pulled from the recall text, making it straightforward to cross-reference affected products against an inventory or procurement system. An extra object holds any additional metadata that does not map to the standard fields.
Endpoint Parameters
get_recalls takes no input parameters. It returns the complete current recall dataset in a single call. There is no built-in filtering by date range, product category, or status — any filtering must be applied client-side against the returned recalls array.
Data Scope
Coverage is limited to recalls and safety alerts listed on BD's public recall page (bd.com). The endpoint reflects the current published state of that listing. Records are scoped to BD's own branded medical device products; recalls from other manufacturers are not included.
- Alert hospital procurement teams when a catalog number in their inventory appears in a new BD recall via
extracted_catalog_numbers. - Build a compliance dashboard that surfaces open recalls by
statusfor medical device distributors. - Monitor
start_datevalues to detect newly published recall notices and trigger automated notifications. - Cross-reference
campaign_idvalues to group related recall records affecting the same product family. - Feed
description_htmlcontent into a clinical safety knowledge base for staff training systems. - Track historical recall frequency and product impact by persisting and diffing responses over time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BD have an official developer API for recall data?+
What does the `extracted_catalog_numbers` field contain?+
extracted_catalog_numbers is an array of product identifiers — catalog numbers and lot designations — parsed from the recall notice text. These let you match recall records against specific product SKUs or lot numbers without manually reading through description_html.Can I filter recalls by date range or product category through the API?+
get_recalls endpoint returns the full active dataset in one call and does not accept filter parameters. Date, status, and product filtering must be applied client-side after retrieving the recalls array. You can fork the API on Parse and revise it to add server-side filtering logic.