Skip to main content

List Assets

Fetch assets based on given criteria.

External Documentation

To learn more, visit the CyCognito documentation.

Basic Parameters

ParameterDescription
Asset TypeSpecify the category of the asset.
FieldsA comma-separated list specifying the desired entity properties to appear in the response.
QuerySpecify a search term for conducting a keyword-based search to retrieve data that matches your query.
Search FieldFilter returned results by specifying the Field, Operator and Value. For more information about the available fields, operators and values, please visit CyCognito documentation, Query Assets section.

Advanced Parameters

ParameterDescription
Advanced SearchAllows to input raw CyQL in order to query assets. For more information, please visit CyCognito Documentation.
LimitDefine the number of results to be retrieved. Valid range is 1-1000.
OffsetSet the starting index for result retrieval, Influenced by the Limit parameter. For example, Offset 3 with Limit 25 fetches results from index 75 to 99.
Sort BySpecify the field by which the results should be sorted.
Sort OrderSelect the sorting order.

Example Output

[
{
"active": true,
"additional-properties": "string",
"advisories": [
"string"
],
"alive": true,
"alive-evidence": "string",
"as-list": [
"string"
],
"asns": [
"string"
],
"attractiveness": 0,
"attractiveness-label": "string",
"attribution-certainty": "string",
"business-units": [
"string"
],
"cidr": "string",
"cis-controls": [
"string"
],
"closed-ports": [
{
"status": "string",
"port": 0,
"protocol": "tcp"
}
],
"cloud-env": "string",
"cloud-env-metadata": [
{
"metadata": "string",
"cloud-env": "string"
}
],
"comment": {
"content": "string",
"last-update": "string"
},
"compliance-violations": [
"string"
],
"continent": [
"string"
],
"country-code": "string",
"created": "string",
"discoverability": "string",
"discovery-path": [
{
"src": "string",
"dest": "string",
"movement-type": "string",
"movement-data": "string"
}
],
"dns-rcode": "string",
"dns-records": "string",
"domain": "string",
"domains": [
"string"
],
"dynamic-dns": "string",
"dynamically-resolved": [
"string"
],
"environments": [
"string"
],
"expiration": "string",
"first-detected": "string",
"first-seen": "string",
"formats": [
"string"
],
"has-form": true,
"has-login": true,
"home-page-description": "string",
"home-page-status-code": 0,
"home-page-title": "string",
"home-page-url": "string",
"hosting-type": "string",
"id": "string",
"investigation-status": "investigating",
"ip": "string",
"ip-addresses": [
"string"
],
"ip-ranges": [
"string"
],
"ips-count": 0,
"is-encrypted": "string",
"is-subdomain": true,
"iso27001-controls": [
"string"
],
"iso27002-controls": [
"string"
],
"issuer-alt-names": [
"string"
],
"issuer-common-name": "string",
"issuer-country": "string",
"issuer-locality": "string",
"issuer-organization": "string",
"issuer-organization-unit": "string",
"issuer-state": "string",
"issues-count": 0,
"known-status": "string",
"last-detected": "string",
"last-seen": "string",
"locations": [
"string"
],
"name-servers": [
"string"
],
"nist-800-171-controls": [
"string"
],
"nist-800-53-controls": [
"string"
],
"open-ports": [
{
"status": "string",
"port": 0,
"protocol": "tcp"
}
],
"organizations": [
"string"
],
"parent-domain": "string",
"pci-dss-controls": [
"string"
],
"platforms": [
"string",
"Unknown Type: null"
],
"ptr-domains": [
"string"
],
"public-key-length": 0,
"public-key-type": "string",
"range": "string",
"range-description": "string",
"range-name": "string",
"region": [
"string"
],
"registered-org-name": "string",
"registrant": "string",
"registrar": "string",
"related": "string",
"related-asset-ids": "string",
"related-screenshot-urls": {},
"revalidation-request-time": "string",
"revalidation-requested": true,
"security-grade": "string",
"security-score": 0,
"serial-number": "string",
"services": [
"string"
],
"serving-machines": "string",
"severe-issues": 0,
"signature": "string",
"signature-algorithm": "string",
"source": "string",
"status": "string",
"subject-alt-names": [
"string"
],
"subject-common-name": "string",
"subject-country": "string",
"subject-locality": "string",
"subject-organization": "string",
"subject-organization-unit": "string",
"subject-state": "string",
"supported-protocols": [
"string"
],
"tags": [
"string"
],
"teams": [
"string"
],
"tech-owners": [
{
"name": "string",
"email": "string",
"org-name": "string"
}
],
"type": "string",
"web-pages": [
"string"
],
"web-resources-urls": [
"string"
],
"web-servers": [
"string"
],
"webapp-address": "string"
}
]

Workflow Library Example

List Assets with Cycognito and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop