--- title: List reclassify submissions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Email Security](https://developers.cloudflare.com/api/go/resources/email_security) [Submissions](https://developers.cloudflare.com/api/go/resources/email_security/subresources/submissions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List 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. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### ParametersExpand Collapse

params SubmissionListParams

AccountID param.Field\[string] Path param: Identifier. maxLength32 Link to this property

Direction param.Field\[SubmissionListParamsDirection]Optional Query param: The sorting direction.

const SubmissionListParamsDirectionAsc SubmissionListParamsDirection = "asc" Link to this property const SubmissionListParamsDirectionDesc SubmissionListParamsDirection = "desc" Link to this property

Link to this property End param.Field\[Time]Optional Query param: The end of the search date range. Defaults to now. formatdate-time Link to this property EscalatedFromUser param.Field\[bool]Optional 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. Link to this property

Order param.Field\[SubmissionListParamsOrder]Optional Query param: Field to sort by.

const SubmissionListParamsOrderSubmissionID SubmissionListParamsOrder = "submission\_id" Link to this property const SubmissionListParamsOrderSubject SubmissionListParamsOrder = "subject" Link to this property const SubmissionListParamsOrderOriginalDisposition SubmissionListParamsOrder = "original\_disposition" Link to this property const SubmissionListParamsOrderRequestedDisposition SubmissionListParamsOrder = "requested\_disposition" Link to this property const SubmissionListParamsOrderOutcomeDisposition SubmissionListParamsOrder = "outcome\_disposition" Link to this property const SubmissionListParamsOrderRequestedAt SubmissionListParamsOrder = "requested\_at" Link to this property

Link to this property

OriginalDisposition param.Field\[SubmissionListParamsOriginalDisposition]Optional Query param: The disposition a message is submitted to have.

const SubmissionListParamsOriginalDispositionMalicious SubmissionListParamsOriginalDisposition = "MALICIOUS" Link to this property const SubmissionListParamsOriginalDispositionSuspicious SubmissionListParamsOriginalDisposition = "SUSPICIOUS" Link to this property const SubmissionListParamsOriginalDispositionSpoof SubmissionListParamsOriginalDisposition = "SPOOF" Link to this property const SubmissionListParamsOriginalDispositionSpam SubmissionListParamsOriginalDisposition = "SPAM" Link to this property const SubmissionListParamsOriginalDispositionBulk SubmissionListParamsOriginalDisposition = "BULK" Link to this property const SubmissionListParamsOriginalDispositionNone SubmissionListParamsOriginalDisposition = "NONE" Link to this property

Link to this property

OutcomeDisposition param.Field\[SubmissionListParamsOutcomeDisposition]Optional Query param: The disposition a message is submitted to have.

const SubmissionListParamsOutcomeDispositionMalicious SubmissionListParamsOutcomeDisposition = "MALICIOUS" Link to this property const SubmissionListParamsOutcomeDispositionSuspicious SubmissionListParamsOutcomeDisposition = "SUSPICIOUS" Link to this property const SubmissionListParamsOutcomeDispositionSpoof SubmissionListParamsOutcomeDisposition = "SPOOF" Link to this property const SubmissionListParamsOutcomeDispositionSpam SubmissionListParamsOutcomeDisposition = "SPAM" Link to this property const SubmissionListParamsOutcomeDispositionBulk SubmissionListParamsOutcomeDisposition = "BULK" Link to this property const SubmissionListParamsOutcomeDispositionNone SubmissionListParamsOutcomeDisposition = "NONE" Link to this property

Link to this property Page param.Field\[int64]Optional Query param: Current page within paginated list of results. minimum1 Link to this property PerPage param.Field\[int64]Optional Query param: The number of results per page. Maximum value is 1000. maximum1000 minimum1 Link to this property Query param.Field\[string]Optional Query param: Search term for filtering submissions. Link to this property

RequestedDisposition param.Field\[SubmissionListParamsRequestedDisposition]Optional Query param: The disposition a message is submitted to have.

const SubmissionListParamsRequestedDispositionMalicious SubmissionListParamsRequestedDisposition = "MALICIOUS" Link to this property const SubmissionListParamsRequestedDispositionSuspicious SubmissionListParamsRequestedDisposition = "SUSPICIOUS" Link to this property const SubmissionListParamsRequestedDispositionSpoof SubmissionListParamsRequestedDisposition = "SPOOF" Link to this property const SubmissionListParamsRequestedDispositionSpam SubmissionListParamsRequestedDisposition = "SPAM" Link to this property const SubmissionListParamsRequestedDispositionBulk SubmissionListParamsRequestedDisposition = "BULK" Link to this property const SubmissionListParamsRequestedDispositionNone SubmissionListParamsRequestedDisposition = "NONE" Link to this property

Link to this property Start param.Field\[Time]Optional Query param: The beginning of the search date range. Defaults to now - 30 days. formatdate-time Link to this property Status param.Field\[string]Optional Query param: Filter by review status — escalated, reviewed, or unreviewed. Link to this property SubmissionID param.Field\[string]Optional Query param: Filter by a specific submission ID. Link to this property

Type param.Field\[SubmissionListParamsType]Optional Query param: Filter by who created the submission — TEAM for security team members or USER for end users.

const SubmissionListParamsTypeTeam SubmissionListParamsType = "TEAM" Link to this property const SubmissionListParamsTypeUser SubmissionListParamsType = "USER" Link to this property

Link to this property

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type SubmissionListResponse struct{…}

RequestedAt Time When the submission was requested (UTC). formatdate-time Link to this property SubmissionID string Link to this property

CustomerStatus SubmissionListResponseCustomerStatusOptional

One of the following: const SubmissionListResponseCustomerStatusEscalated SubmissionListResponseCustomerStatus = "escalated" Link to this property const SubmissionListResponseCustomerStatusReviewed SubmissionListResponseCustomerStatus = "reviewed" Link to this property const SubmissionListResponseCustomerStatusUnreviewed SubmissionListResponseCustomerStatus = "unreviewed" Link to this property

Link to this property

EscalatedAs SubmissionListResponseEscalatedAsOptional The disposition a message is submitted to have.

One of the following: const SubmissionListResponseEscalatedAsMalicious SubmissionListResponseEscalatedAs = "MALICIOUS" Link to this property const SubmissionListResponseEscalatedAsSuspicious SubmissionListResponseEscalatedAs = "SUSPICIOUS" Link to this property const SubmissionListResponseEscalatedAsSpoof SubmissionListResponseEscalatedAs = "SPOOF" Link to this property const SubmissionListResponseEscalatedAsSpam SubmissionListResponseEscalatedAs = "SPAM" Link to this property const SubmissionListResponseEscalatedAsBulk SubmissionListResponseEscalatedAs = "BULK" Link to this property const SubmissionListResponseEscalatedAsNone SubmissionListResponseEscalatedAs = "NONE" Link to this property

Link to this property EscalatedAt TimeOptional When the submission was escalated to the security team. formatdate-time Link to this property EscalatedBy stringOptional Email address of the user who escalated the submission. Link to this property EscalatedSubmissionID stringOptional Submission ID of the escalated team submission, when this user submission was escalated. Link to this property

OriginalDisposition SubmissionListResponseOriginalDispositionOptional The disposition a message is submitted to have.

One of the following: const SubmissionListResponseOriginalDispositionMalicious SubmissionListResponseOriginalDisposition = "MALICIOUS" Link to this property const SubmissionListResponseOriginalDispositionSuspicious SubmissionListResponseOriginalDisposition = "SUSPICIOUS" Link to this property const SubmissionListResponseOriginalDispositionSpoof SubmissionListResponseOriginalDisposition = "SPOOF" Link to this property const SubmissionListResponseOriginalDispositionSpam SubmissionListResponseOriginalDisposition = "SPAM" Link to this property const SubmissionListResponseOriginalDispositionBulk SubmissionListResponseOriginalDisposition = "BULK" Link to this property const SubmissionListResponseOriginalDispositionNone SubmissionListResponseOriginalDisposition = "NONE" Link to this property

Link to this property OriginalEdfHash stringOptional EDF hash of the original message. Link to this property OriginalPostfixID stringOptional The postfix ID of the original message that was submitted. Link to this property Outcome stringOptional Processing outcome of the submission. Link to this property

OutcomeDisposition SubmissionListResponseOutcomeDispositionOptional The disposition a message is submitted to have.

One of the following: const SubmissionListResponseOutcomeDispositionMalicious SubmissionListResponseOutcomeDisposition = "MALICIOUS" Link to this property const SubmissionListResponseOutcomeDispositionSuspicious SubmissionListResponseOutcomeDisposition = "SUSPICIOUS" Link to this property const SubmissionListResponseOutcomeDispositionSpoof SubmissionListResponseOutcomeDisposition = "SPOOF" Link to this property const SubmissionListResponseOutcomeDispositionSpam SubmissionListResponseOutcomeDisposition = "SPAM" Link to this property const SubmissionListResponseOutcomeDispositionBulk SubmissionListResponseOutcomeDisposition = "BULK" Link to this property const SubmissionListResponseOutcomeDispositionNone SubmissionListResponseOutcomeDisposition = "NONE" Link to this property

Link to this property RequestedBy stringOptional Email address of the user who requested the submission. Link to this property

RequestedDisposition SubmissionListResponseRequestedDispositionOptional The disposition a message is submitted to have.

One of the following: const SubmissionListResponseRequestedDispositionMalicious SubmissionListResponseRequestedDisposition = "MALICIOUS" Link to this property const SubmissionListResponseRequestedDispositionSuspicious SubmissionListResponseRequestedDisposition = "SUSPICIOUS" Link to this property const SubmissionListResponseRequestedDispositionSpoof SubmissionListResponseRequestedDisposition = "SPOOF" Link to this property const SubmissionListResponseRequestedDispositionSpam SubmissionListResponseRequestedDisposition = "SPAM" Link to this property const SubmissionListResponseRequestedDispositionBulk SubmissionListResponseRequestedDisposition = "BULK" Link to this property const SubmissionListResponseRequestedDispositionNone SubmissionListResponseRequestedDisposition = "NONE" Link to this property

Link to this property DeprecatedRequestedTs stringOptional Use requested_at instead. Deprecated, use requested_at instead. Link to this property Status stringOptional Processing status of the submission. Link to this property Subject stringOptional Subject line of the submitted message. Link to this property

Type SubmissionListResponseTypeOptional Indicates whether a team member or an end user created the submission.

One of the following: const SubmissionListResponseTypeTeam SubmissionListResponseType = "Team" Link to this property const SubmissionListResponseTypeUser SubmissionListResponseType = "User" Link to this property

Link to this property

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(model)%20SubmissionListResponse%20%3E%20(schema)>) ### List reclassify submissions Go HTTPTypeScriptPythonGoTerraform ``` 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) } ``` 200 example ``` { "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 } } ``` ##### Returns Examples 200 example ``` { "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 } } ```