## Get reclassify submissions `client.EmailSecurity.Submissions.List(ctx, params) (*V4PagePaginationArray[SubmissionListResponse], error)` **get** `/accounts/{account_id}/email-security/submissions` Returns information for submissions made to reclassify emails. Shows the status, outcome, and disposition changes for reclassification requests made by users or the security team. Useful for tracking false positive/negative reports. ### Parameters - `params SubmissionListParams` - `AccountID param.Field[string]` Path param: Identifier. - `End param.Field[Time]` Query param: The end of the search date range. Defaults to `now`. - `EscalatedFromUser param.Field[bool]` Query param: When true, return only submissions that were escalated by an end user (vs. by the security team). When false, return only submissions that were not escalated by an end user. When omitted, no filter is applied. - `OriginalDisposition param.Field[SubmissionListParamsOriginalDisposition]` Query param - `const SubmissionListParamsOriginalDispositionMalicious SubmissionListParamsOriginalDisposition = "MALICIOUS"` - `const SubmissionListParamsOriginalDispositionSuspicious SubmissionListParamsOriginalDisposition = "SUSPICIOUS"` - `const SubmissionListParamsOriginalDispositionSpoof SubmissionListParamsOriginalDisposition = "SPOOF"` - `const SubmissionListParamsOriginalDispositionSpam SubmissionListParamsOriginalDisposition = "SPAM"` - `const SubmissionListParamsOriginalDispositionBulk SubmissionListParamsOriginalDisposition = "BULK"` - `const SubmissionListParamsOriginalDispositionNone SubmissionListParamsOriginalDisposition = "NONE"` - `OutcomeDisposition param.Field[SubmissionListParamsOutcomeDisposition]` Query param - `const SubmissionListParamsOutcomeDispositionMalicious SubmissionListParamsOutcomeDisposition = "MALICIOUS"` - `const SubmissionListParamsOutcomeDispositionSuspicious SubmissionListParamsOutcomeDisposition = "SUSPICIOUS"` - `const SubmissionListParamsOutcomeDispositionSpoof SubmissionListParamsOutcomeDisposition = "SPOOF"` - `const SubmissionListParamsOutcomeDispositionSpam SubmissionListParamsOutcomeDisposition = "SPAM"` - `const SubmissionListParamsOutcomeDispositionBulk SubmissionListParamsOutcomeDisposition = "BULK"` - `const SubmissionListParamsOutcomeDispositionNone SubmissionListParamsOutcomeDisposition = "NONE"` - `Page param.Field[int64]` Query param: Current page within paginated list of results. - `PerPage param.Field[int64]` Query param: The number of results per page. Maximum value is 1000. - `Query param.Field[string]` Query param - `RequestedDisposition param.Field[SubmissionListParamsRequestedDisposition]` Query param - `const SubmissionListParamsRequestedDispositionMalicious SubmissionListParamsRequestedDisposition = "MALICIOUS"` - `const SubmissionListParamsRequestedDispositionSuspicious SubmissionListParamsRequestedDisposition = "SUSPICIOUS"` - `const SubmissionListParamsRequestedDispositionSpoof SubmissionListParamsRequestedDisposition = "SPOOF"` - `const SubmissionListParamsRequestedDispositionSpam SubmissionListParamsRequestedDisposition = "SPAM"` - `const SubmissionListParamsRequestedDispositionBulk SubmissionListParamsRequestedDisposition = "BULK"` - `const SubmissionListParamsRequestedDispositionNone SubmissionListParamsRequestedDisposition = "NONE"` - `Start param.Field[Time]` Query param: The beginning of the search date range. Defaults to `now - 30 days`. - `Status param.Field[string]` Query param - `SubmissionID param.Field[string]` Query param - `Type param.Field[SubmissionListParamsType]` Query param - `const SubmissionListParamsTypeTeam SubmissionListParamsType = "TEAM"` - `const SubmissionListParamsTypeUser SubmissionListParamsType = "USER"` ### Returns - `type SubmissionListResponse struct{…}` - `RequestedAt Time` When the submission was requested (UTC). - `SubmissionID string` - `CustomerStatus SubmissionListResponseCustomerStatus` - `const SubmissionListResponseCustomerStatusEscalated SubmissionListResponseCustomerStatus = "escalated"` - `const SubmissionListResponseCustomerStatusReviewed SubmissionListResponseCustomerStatus = "reviewed"` - `const SubmissionListResponseCustomerStatusUnreviewed SubmissionListResponseCustomerStatus = "unreviewed"` - `EscalatedAs SubmissionListResponseEscalatedAs` - `const SubmissionListResponseEscalatedAsMalicious SubmissionListResponseEscalatedAs = "MALICIOUS"` - `const SubmissionListResponseEscalatedAsSuspicious SubmissionListResponseEscalatedAs = "SUSPICIOUS"` - `const SubmissionListResponseEscalatedAsSpoof SubmissionListResponseEscalatedAs = "SPOOF"` - `const SubmissionListResponseEscalatedAsSpam SubmissionListResponseEscalatedAs = "SPAM"` - `const SubmissionListResponseEscalatedAsBulk SubmissionListResponseEscalatedAs = "BULK"` - `const SubmissionListResponseEscalatedAsNone SubmissionListResponseEscalatedAs = "NONE"` - `EscalatedAt Time` - `EscalatedBy string` - `EscalatedSubmissionID string` - `OriginalDisposition SubmissionListResponseOriginalDisposition` - `const SubmissionListResponseOriginalDispositionMalicious SubmissionListResponseOriginalDisposition = "MALICIOUS"` - `const SubmissionListResponseOriginalDispositionSuspicious SubmissionListResponseOriginalDisposition = "SUSPICIOUS"` - `const SubmissionListResponseOriginalDispositionSpoof SubmissionListResponseOriginalDisposition = "SPOOF"` - `const SubmissionListResponseOriginalDispositionSpam SubmissionListResponseOriginalDisposition = "SPAM"` - `const SubmissionListResponseOriginalDispositionBulk SubmissionListResponseOriginalDisposition = "BULK"` - `const SubmissionListResponseOriginalDispositionNone SubmissionListResponseOriginalDisposition = "NONE"` - `OriginalEdfHash string` - `OriginalPostfixID string` The postfix ID of the original message that was submitted - `Outcome string` - `OutcomeDisposition SubmissionListResponseOutcomeDisposition` - `const SubmissionListResponseOutcomeDispositionMalicious SubmissionListResponseOutcomeDisposition = "MALICIOUS"` - `const SubmissionListResponseOutcomeDispositionSuspicious SubmissionListResponseOutcomeDisposition = "SUSPICIOUS"` - `const SubmissionListResponseOutcomeDispositionSpoof SubmissionListResponseOutcomeDisposition = "SPOOF"` - `const SubmissionListResponseOutcomeDispositionSpam SubmissionListResponseOutcomeDisposition = "SPAM"` - `const SubmissionListResponseOutcomeDispositionBulk SubmissionListResponseOutcomeDisposition = "BULK"` - `const SubmissionListResponseOutcomeDispositionNone SubmissionListResponseOutcomeDisposition = "NONE"` - `RequestedBy string` - `RequestedDisposition SubmissionListResponseRequestedDisposition` - `const SubmissionListResponseRequestedDispositionMalicious SubmissionListResponseRequestedDisposition = "MALICIOUS"` - `const SubmissionListResponseRequestedDispositionSuspicious SubmissionListResponseRequestedDisposition = "SUSPICIOUS"` - `const SubmissionListResponseRequestedDispositionSpoof SubmissionListResponseRequestedDisposition = "SPOOF"` - `const SubmissionListResponseRequestedDispositionSpam SubmissionListResponseRequestedDisposition = "SPAM"` - `const SubmissionListResponseRequestedDispositionBulk SubmissionListResponseRequestedDisposition = "BULK"` - `const SubmissionListResponseRequestedDispositionNone SubmissionListResponseRequestedDisposition = "NONE"` - `RequestedTs string` Deprecated, use `requested_at` instead - `Status string` - `Subject string` - `Type SubmissionListResponseType` Whether the submission was created by a team member or an end user. - `const SubmissionListResponseTypeTeam SubmissionListResponseType = "Team"` - `const SubmissionListResponseTypeUser SubmissionListResponseType = "User"` ### Example ```go package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/email_security" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.EmailSecurity.Submissions.List(context.TODO(), email_security.SubmissionListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "requested_at": "2019-12-27T18:11:19.117Z", "submission_id": "submission_id", "customer_status": "escalated", "escalated_as": "MALICIOUS", "escalated_at": "2019-12-27T18:11:19.117Z", "escalated_by": "escalated_by", "escalated_submission_id": "escalated_submission_id", "original_disposition": "MALICIOUS", "original_edf_hash": "original_edf_hash", "original_postfix_id": "original_postfix_id", "outcome": "outcome", "outcome_disposition": "MALICIOUS", "requested_by": "requested_by", "requested_disposition": "MALICIOUS", "requested_ts": "requested_ts", "status": "status", "subject": "subject", "type": "Team" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```