Lists scans.

Basic Parameters

ParameterDescription
FromThe starting date and time to filter scan results. Only scans performed after this timestamp will be included in the results.
OriginThe channel that performed the scan.
Sender Email AddressInclude results that were sent from the specified email address.
ToThe ending date and time to filter scan results. Only scans performed before this timestamp will be included in the results.
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