API Reference

Aggregate supply chain assets

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

Aggregate assets across your supply chain by a given field. By default, the aggregation covers every supplier in your supply chain. Provide supplier_ids to narrow it to specific suppliers.

This functionality is equivalent to the Report Builder in the Platform UI.

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
string

Specifies which document level's count is returned per term bucket, primarily for nested fields. This is the same functionality available in the Count By dropdown in the Report Builder UI. When aggregating on nested fields like 'host.services.port': empty string (default) counts documents at the deepest level containing the field; '.' counts root documents (e.g. counts matching 'host'); 'host.services' counts documents at the specified nested level.

string
required

field to aggregate by

boolean
Defaults to false

Controls whether aggregation results are limited to values that match the query. When true, only field values that satisfy the query constraints are included in aggregation counts. When false, aggregation includes all field values from records that match the query, even if those specific field values don't match the query constraints. For example, if the query is 'host.services.protocol=SSH' and you are aggregating by 'host.services.port' - when true, only shows SSH ports; when false, shows all ports on hosts that have SSH services.

int64
required
1 to 2000

number of buckets to split results into

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 aggregation to, each as a unique UUID string. When omitted, the entire supply chain is aggregated.

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 3 months 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 3 months ago

Did this page help you?