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": 42172468,
	"page_result_count": 21,
	"next": "<string>",
	"has_more": true,
	"results": [
		{
			"max_group_size": 1,
			"scan_layers": [],
			"sample_file_type": "<string>",
			"verbose_confidence": null,
			"highlighted": false,
			"id": "<string>",
			"origin": "<string>",
			"root_scan_id": "<string>",
			"finished_at": "<string>",
			"verbose_verdict": "<string>",
			"organization_id": 274,
			"confidence": 1,
			"verbose_action": "<string>",
			"allowed_to_dispute": false,
			"scan_engines": [],
			"sub_origin": "<string>",
			"organization_display_name": "<string>",
			"full_scan_id": "<string>",
			"organization_is_demo": false,
			"root_scan_summary": {
				"is_fn": false,
				"was_requested_for_investigation": false,
				"sub_verdict": "<string>",
				"verbose_verdict": "<string>"
			},
			"payload_type": "<string>",
			"decisions": [],
			"sample": {
				"source_ip": "<string>",
				"return_path_address_mail_box": "<string>",
				"headers": null,
				"file_size": null,
				"sha256": "<string>",
				"from_address": "<string>",
				"sender_domain": "<string>",
				"last_action_time": null,
				"last_action": "<string>",
				"cc_addresses": "<string>",
				"delivery_time": null,
				"sha1": "<string>",
				"pe_icon_link": null,
				"return_path_address_main_domain": "<string>",
				"recipients": "<string>",
				"receiver_domain": "<string>",
				"to_addresses": "<string>",
				"message_id": "<string>",
				"md5": "<string>"
			},
			"organization_origin": "<string>",
			"attachments_names": null,
			"max_external_bulk_size": 1,
			"queued_for_bulk_action": false,
			"user_selected_verdict": false,
			"parent_organization_display_name": "<string>",
			"created_at": "<string>",
			"attachment": null,
			"allow_create_screenshots": null,
			"is_highlighted": null,
			"verbose_origin": "<string>",
			"sample_to": "<string>",
			"parent_organization_name": "<string>",
			"organization_name": "<string>",
			"allowed_copy_to_demo": true,
			"evidence": [],
			"ir_decision": null,
			"sample_to_type": "<string>",
			"sample_title": "<string>",
			"verdict_changed_at": "<string>",
			"group_keys": [],
			"search_descendants": [
				{
					"source_ip": "<string>",
					"group_keys": [],
					"scan_layers": [],
					"headers": null,
					"verdict_changed_by": "<string>",
					"envelope_to": "<string>",
					"verbose_status": "<string>",
					"reply_to": "<string>",
					"sample_from": "<string>",
					"parent_scan_id": "<string>",
					"upload": "<string>",
					"from_address": "<string>",
					"decisions": [],
					"original_message_id": "<string>",
					"subject": "<string>",
					"malicious_file_link": null,
					"sample_sha256": "<string>",
					"verbose_verdict": "<string>",
					"sample_type_str": "<string>",
					"recipients": "<string>",
					"receiver_domain": "<string>",
					"to_addresses": "<string>",
					"scan_traces_count": 1,
					"scan_id": "<string>",
					"sample_title": "<string>",
					"source": "<string>"
				}
			],
			"verbose_automation_status": null,
			"is_bcc_domain": false,
			"can_pull_from_inbox": true,
			"verbose_status": "<string>",
			"marked_as_fp_by": null,
			"sample_from": "<string>",
			"sub_verdict": "<string>",
			"organization_risk_rating": "<string>",
			"handle_status": "<string>",
			"organization_contract": "<string>",
			"is_fn": false,
			"was_requested_for_investigation": false,
			"sample_type_str": "<string>",
			"sample_from_type": "<string>",
			"images": []
		},
		{
			"max_group_size": 1,
			"scan_layers": [],
			"sample_file_type": "<string>",
			"verbose_confidence": null,
			"highlighted": false,
			"id": "<string>",
			"origin": "<string>",
			"root_scan_id": "<string>",
			"finished_at": "<string>",
			"verbose_verdict": "<string>",
			"organization_id": 221,
			"confidence": 1,
			"verbose_action": "<string>",
			"allowed_to_dispute": false,
			"scan_engines": [],
			"sub_origin": "<string>",
			"organization_display_name": "<string>",
			"full_scan_id": "<string>",
			"organization_is_demo": false,
			"root_scan_summary": {
				"is_fn": false,
				"was_requested_for_investigation": false,
				"sub_verdict": "<string>",
				"verbose_verdict": "<string>"
			},
			"payload_type": "<string>",
			"decisions": [],
			"sample": {
				"source_ip": "<string>",
				"return_path_address_mail_box": "<string>",
				"headers": null,
				"file_size": null,
				"sha256": "<string>",
				"from_address": "<string>",
				"sender_domain": "<string>",
				"last_action_time": null,
				"last_action": "<string>",
				"cc_addresses": "<string>",
				"delivery_time": null,
				"sha1": "<string>",
				"pe_icon_link": null,
				"return_path_address_main_domain": "<string>",
				"recipients": "<string>",
				"receiver_domain": "<string>",
				"to_addresses": "<string>",
				"message_id": "<string>",
				"md5": "<string>"
			},
			"organization_origin": "<string>",
			"attachments_names": null,
			"max_external_bulk_size": 1,
			"queued_for_bulk_action": false,
			"user_selected_verdict": false,
			"parent_organization_display_name": "<string>",
			"created_at": "<string>",
			"attachment": null,
			"allow_create_screenshots": null,
			"is_highlighted": null,
			"verbose_origin": "<string>",
			"sample_to": "<string>",
			"parent_organization_name": "<string>",
			"organization_name": "<string>",
			"allowed_copy_to_demo": true,
			"evidence": [],
			"ir_decision": null,
			"sample_to_type": "<string>",
			"sample_title": "<string>",
			"verdict_changed_at": "<string>",
			"group_keys": [],
			"search_descendants": [
				{
					"source_ip": "<string>",
					"group_keys": [],
					"scan_layers": [],
					"headers": null,
					"verdict_changed_by": "<string>",
					"envelope_to": "<string>",
					"verbose_status": "<string>",
					"reply_to": "<string>",
					"sample_from": "<string>",
					"parent_scan_id": "<string>",
					"upload": "<string>",
					"from_address": "<string>",
					"decisions": [],
					"original_message_id": "<string>",
					"subject": "<string>",
					"malicious_file_link": null,
					"sample_sha256": "<string>",
					"verbose_verdict": "<string>",
					"sample_type_str": "<string>",
					"recipients": "<string>",
					"receiver_domain": "<string>",
					"to_addresses": "<string>",
					"scan_traces_count": 0,
					"scan_id": "<string>",
					"sample_title": "<string>",
					"source": "<string>"
				}
			],
			"verbose_automation_status": null,
			"is_bcc_domain": false,
			"can_pull_from_inbox": true,
			"verbose_status": "<string>",
			"marked_as_fp_by": null,
			"sample_from": "<string>",
			"sub_verdict": "<string>",
			"organization_risk_rating": "<string>",
			"handle_status": "<string>",
			"organization_contract": "<string>",
			"is_fn": false,
			"was_requested_for_investigation": false,
			"sample_type_str": "<string>",
			"sample_from_type": "<string>",
			"images": []
		}
	],
	"aggregations": null
}

Workflow Library Example

List Scans with Perception Point and Send Results Via Email

Preview this Workflow on desktop