API Reference

Search supply chain assets

post
https://api.platform.censys.io/v1/supplychains//assets/search

Search for assets across a supply chain. By default the search covers every supplier in the supply chain; provide supplier_ids to narrow it to specific suppliers. Reference the documentation on Censys Query Language for information about query syntax.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
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.

Body Params
fields
array of strings | null

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.

fields
int64 | null
≥ 0

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

string

page token for the requested page of search results

string
required

CenQL query string to search upon

supplier_ids
array of uuids | null

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.

supplier_ids
Query Params
uuid
required

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

Headers
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.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 2 days ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated 2 days ago

Did this page help you?