Lists scans.

Basic Parameters

ParameterDescription
From-
OriginThe channel that performed the scan.
Sender Email AddressInclude results that were sent from the specified email address.
To-
VerdictThe verdict of the scans.

Advanced Parameters

ParameterDescription
Email ReceiverThe receiver of the email associated to the scan.
Message IDThe message ID associated to the scan.

Example Output

{
	"count": 1,
	"page_result_count": 1,
	"next": "https://api.eu.perception-point.io/api/v1/scans/list/?_cursor=2023-06-07T06%3A06%3A23.977221",
	"has_more": false,
	"results": [
		{
			"organization_display_name": "Blinkops",
			"origin": "api",
			"full_scan_id": "001E94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
			"is_highlighted": null,
			"evidence": [
				{
					"trace_id": "",
					"data": {
						"evidence_creator_id": 151,
						"evidence_creator_name": "window hash"
					},
					"identifiers": "[]",
					"confidence": 0,
					"description": "",
					"full_key": "scanevidenceredis:id.94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ce61f647-ae13-45d5-be20-175162c62316_20230607:e09150f23bab3c4b69d40e261a08d2a9",
					"root_scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"verdict": "",
					"name": "window.hash",
					"scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"category": "html_content",
					"key": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:e09150f23bab3c4b69d40e261a08d2a9",
					"timestamp": 1686020644.5416307
				},
				{
					"trace_id": "",
					"data": {
						"evidence_creator_id": 232,
						"evidence_creator_name": "Microsoft collecting data"
					},
					"identifiers": "[]",
					"confidence": 0,
					"description": "",
					"full_key": "scanevidenceredis:id.94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:3a09a3ec812e8f386d01878b2d71cd1c",
					"root_scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"verdict": "",
					"name": "microsoft_in_html_content",
					"scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"category": "html_content",
					"key": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:3a09a3ec812e8f386d01878b2d71cd1c",
					"timestamp": 1686020644.6670082
				},
				{
					"trace_id": "",
					"data": {
						"evidence_creator_id": 130,
						"evidence_creator_name": "Event Listener"
					},
					"identifiers": "[]",
					"confidence": 0,
					"description": "",
					"full_key": "scanevidenceredis:id.94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:d94c59fc326a77527869c563e3352d05",
					"root_scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"verdict": "",
					"name": "add_event_listener",
					"scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"category": "html_content",
					"key": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607:d94c59fc326a77527869c563e3352d05",
					"timestamp": 1686020644.4809675
				}
			],
			"attachments_names": null,
			"ir_decision": null,
			"max_group_size": 0,
			"verbose_action": null,
			"created_at": "2023-06-07T06:06:23.986660",
			"finished_at": "2023-06-07T06:06:31.424219",
			"sample_to_type": null,
			"payload_type": null,
			"verbose_status": "CMP",
			"verdict_changed_at": "2023-06-07T06:06:31.350853",
			"group_keys": [],
			"was_requested_for_investigation": false,
			"root_scan_summary": {
				"is_fn": false,
				"was_requested_for_investigation": false,
				"sub_verdict": "CLN",
				"verbose_verdict": "CLN"
			},
			"sample_file_type": "url",
			"sample_title": "http://blinkops.com",
			"organization_name": "Blink",
			"confidence": 0,
			"scan_engines": [],
			"sub_verdict": "CLN",
			"search_descendants": [
				{
					"verdict_changed_by": "System",
					"scan_traces_count": 0,
					"path": "http://blinkops.com",
					"sample_sha256": "ef087002b08e95579488b3e8107a5b759572fd762b2adfb1fee36ce133effa00",
					"verbose_status": "CMP",
					"group_keys": [],
					"url_title": "Blink | No-Code Security Platform with 7000+ Automations",
					"sample_title": "http://blinkops.com",
					"upload": null,
					"url_description": "",
					"parent_scan_id": "",
					"malicious_file_link": null,
					"verbose_verdict": "CLN",
					"sample_type_str": "url",
					"scan_id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
					"domain": "blinkops.com",
					"headers": null,
					"scan_layers": [],
					"decisions": [
						{
							"verdict": "UNDF",
							"decision_name": "URL - only domain with high clean ratio",
							"category": ""
						}
					],
					"sample_from": ""
				}
			],
			"queued_for_bulk_action": false,
			"parent_organization_display_name": "Example",
			"is_fn": false,
			"sample_to": null,
			"root_scan_id": "",
			"max_external_bulk_size": 0,
			"verbose_confidence": null,
			"verbose_verdict": "CLN",
			"marked_as_fp_by": null,
			"sub_origin": "",
			"highlighted": false,
			"organization_id": 94824,
			"sample_type_str": "url",
			"organization_is_demo": false,
			"id": "94824_1_ab2ee57f-ae13-45d5-be20-175162c62316_20230607",
			"sample": {
				"sha256": "ef087002b08e95579488b3e8107a5b759572fd762b2adfb1fee36ce133effa00",
				"domain": "blinkops.com",
				"md5": "61c383fbd5f4169447a1445fdc5ac889",
				"headers": null,
				"pe_icon_link": null,
				"sha1": "dea90a88f298ec19f070a5662fcaba05fec4fe64",
				"url_title": "Blink | No-Code Security Platform with 7000+ Automations",
				"file_size": null,
				"path": "http://blinkops.com",
				"delivery_time": null
			},
			"sample_from_type": null,
			"scan_layers": [],
			"attachment": null,
			"decisions": [],
			"images": [],
			"verbose_automation_status": null,
			"handle_status": "AAP",
			"sample_from": "",
			"parent_organization_name": "Qmasters",
			"verbose_origin": "api"
		}
	],
	"aggregations": null
}

Workflow Library Example

List Scans with Perception Point and Send Results Via Email

Preview this Workflow on desktop