Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Supply Chain Intelligence

List risks

Returns the risks (vulnerabilities, misconfigurations, and exposures) identified across a supply chain. By default the entire supply chain is searched; provide supplier_ids to narrow the search to specific suppliers.

get/v1/supplychains/{supply_chain_id}/risks

Path parameters

supply_chain_idstring uuid required

The ID of a Censys supply chain. Obtain the supply chain ID using the list supply chains endpoint to find the IDs of your organization's supply chains.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys supply chain. Obtain the supply chain ID using the list supply chains endpoint to find the IDs of your organization's supply chains.

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

supplier_idsstring[] nullable

Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.

Narrow the search to one or more Censys suppliers in the supply chain. For multiple values, include comma-separated values. When omitted, the entire supply chain is searched.

[
  "11111111-2222-3333-4444-555555555555"
]
querystring

A CenQL query. When set, only risks present on assets matching this query are returned.

A CenQL query. When set, only risks present on assets matching this query are returned.

risk_type'misconfigs' | 'vulns' | 'exposures'

Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, and exposures are all included.

Filter to a single risk category. When omitted, misconfigurations, vulnerabilities, and exposures are all included.

resource_type'hosts' | 'web'

Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.

Filter to risks observed on a single asset resource type. When omitted, hosts and web are both included.

page_sizeinteger

Maximum number of risks to return per page.

Maximum number of risks to return per page.

page_tokenstring

Pagination token from a previous response to retrieve the next page of results.

Pagination token from a previous response to retrieve the next page of results.

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Response

Risk information returned successfully

Example response

{
  "result": {
    "risks": [
      {
        "id": "CVE-2016-20012"
      }
    ]
  }
}