Skip to main content
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
Workflow LibraryPreview this Workflow on desktop
I