Supplier Risk

Search supply chain assets

Changed on Nov 3, 2026

Search for assets across your supply chain. By default the search covers every supplier in the supply chain. Provide supplier_ids to narrow your search. Use default as the supply chain ID to target your organization's primary supply chain. Reference the documentation on Censys Query Language for information about query syntax.

post/v1/supplychains/{supply_chain_id}/assets/search

Request

Base URL
https://api.platform.censys.io
URL
https://api.platform.censys.io/v1/supplychains/{supply_chain_id}/assets/search
Auth
HTTP bearer

Path parameters

supply_chain_idstring required

The ID of a Censys supply chain, or the literal 'default' for your organization's primary supply chain. Obtain the supply chain ID using the list supply chains endpoint or from the Supplier Risk URL in the web console.

Example:11111111-2222-3333-4444-555555555555

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

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

Request body

fieldsstring[] nullable

Specify fields to only return in the response. If you provide fields and omit host.services.port, host.services.transport_protocol, and host.services.protocol, then matched_services will not be returned in the response.

page_sizeinteger nullable

Number of results to return to per page. The default and maximum is 100.

page_tokenstring

page token for the requested page of search results

querystring required

CenQL query string to search upon

supplier_idsstring[] nullable

The IDs of Censys suppliers in the supply chain to narrow the search to, each as a unique UUID string. When omitted, the entire supply chain is searched.

Example request

{
  "query": "host.services: (protocol=SSH and not port: 22)",
  "supplier_ids": [
    "11111111-2222-3333-4444-555555555555"
  ]
}

Response

Assets found successfully

Changes

Nov 3, 2026ec1686b0a36a Revision changes
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the /////// response's property format changed from hex to no format for status
- breaking
  the //////////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////////// response's property format changed from utf8 to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the ///////// response's property format changed from utf8 to no format for status
- breaking
  the ///////// response's property format changed from utf8 to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- breaking
  the ///////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the //// response's property type changed from string to object for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from hex to no format for status
- breaking
  the //////// response's property format changed from hex to no format for status
- breaking
  the ////////// response's property format changed from utf8 to no format for status
- breaking
  the //////// response's property format changed from utf8 to no format for status
- info
  api tag Supplier Risk added
- info
  api tag Supply Chain Intelligence removed
- info
  for the path request parameter supply_chain_id, the format was generalized from uuid to no format
- info
  added the non-success response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the required property ///// to the response with the status
- info
  added the required property ///// to the response with the status

Operation history

Search supply chain assets

Request

Path parameters

Query parameters

Headers

Request body

Example request

Response 200OK

Changes

Response