Skip to content

Catalog

The catalog endpoints expose the vendor and protocol reference data used for asset matching and watchlist subscriptions.

Endpoints

Method Path Description
GET /api/v1/catalog/vendors List vendors
GET /api/v1/catalog/vendors/{id} Get vendor detail
GET /api/v1/catalog/protocols List protocols
GET /api/v1/catalog/protocols/{id} Get protocol detail

List Vendors

curl -H "Authorization: Bearer bs_live_..." \
  "https://breachspider.com/api/v1/catalog/vendors?q=siemens"

{
  "data": [
    {
      "id": 142,
      "name": "Siemens",
      "slug": "siemens",
      "cve_count": 1842,
      "ics_vendor": true
    }
  ]
}

List Protocols

curl -H "Authorization: Bearer bs_live_..." \
  "https://breachspider.com/api/v1/catalog/protocols"

{
  "data": [
    {"id": 7, "name": "Modbus", "cve_count": 84, "ics_protocol": true},
    {"id": 12, "name": "DNP3", "cve_count": 31, "ics_protocol": true},
    {"id": 3, "name": "OPC-UA", "cve_count": 58, "ics_protocol": true}
  ]
}

Common ICS Vendor IDs

Use GET /api/v1/catalog/vendors?q= to find IDs for your vendors. Notable tracked vendors include Siemens, Schneider Electric, Rockwell Automation, ABB, Honeywell, Mitsubishi Electric, Omron, Yokogawa, Beckhoff, GE Vernova, Emerson, AVEVA, Johnson Controls, Advantech, and Moxa.