--- title: List reclassify submissions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Security](https://developers.cloudflare.com/api/python/resources/email_security) [Submissions](https://developers.cloudflare.com/api/python/resources/email_security/subresources/submissions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List reclassify submissions email\_security.submissions.list(SubmissionListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[SubmissionListResponse]()] 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 account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)

direction: Optional\[Literal\["asc", "desc"]] The sorting direction.

One of the following: "asc" Link to this property "desc" Link to this property

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) end: Optional\[Union\[str, datetime]] The end of the search date range. Defaults to `now`. formatdate-time [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20end%20%3E%20(schema)>) escalated\_from\_user: Optional\[[bool]()] 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](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20escalated_from_user%20%3E%20(schema)>)

order: Optional\[Literal\["submission\_id", "subject", "original\_disposition", 3 more]] Field to sort by.

One of the following: "submission\_id" Link to this property "subject" Link to this property "original\_disposition" Link to this property "requested\_disposition" Link to this property "outcome\_disposition" Link to this property "requested\_at" Link to this property

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

original\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

One of the following: "MALICIOUS" Link to this property "SUSPICIOUS" Link to this property "SPOOF" Link to this property "SPAM" Link to this property "BULK" Link to this property "NONE" Link to this property

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

outcome\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20outcome_disposition%20%3E%20(schema)>) page: Optional\[int] Current page within paginated list of results. minimum1 [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] The number of results per page. Maximum value is 1000. maximum1000 minimum1 [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) query: Optional\[str] Search term for filtering submissions. [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20query%20%3E%20(schema)>)

requested\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20requested_disposition%20%3E%20(schema)>) start: Optional\[Union\[str, datetime]] The beginning of the search date range. Defaults to `now - 30 days`. formatdate-time [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20start%20%3E%20(schema)>) status: Optional\[str] Filter by review status — `escalated`, `reviewed`, or `unreviewed`. [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) submission\_id: Optional\[str] Filter by a specific submission ID. [Link to this property](<#(resource)%20email_security.submissions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20submission_id%20%3E%20(schema)>)

type: Optional\[Literal\["TEAM", "USER"]] Filter by who created the submission — TEAM for security team members or USER for end users.

One of the following: "TEAM" Link to this property "USER" Link to this property

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

class SubmissionListResponse: …

requested\_at: datetime When the submission was requested (UTC). formatdate-time Link to this property submission\_id: str Link to this property

customer\_status: Optional\[Literal\["escalated", "reviewed", "unreviewed"]]

One of the following: "escalated" Link to this property "reviewed" Link to this property "unreviewed" Link to this property

Link to this property

escalated\_as: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

Link to this property escalated\_at: Optional\[datetime] When the submission was escalated to the security team. formatdate-time Link to this property escalated\_by: Optional\[str] Email address of the user who escalated the submission. Link to this property escalated\_submission\_id: Optional\[str] Submission ID of the escalated team submission, when this user submission was escalated. Link to this property

original\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

Link to this property original\_edf\_hash: Optional\[str] EDF hash of the original message. Link to this property original\_postfix\_id: Optional\[str] The postfix ID of the original message that was submitted. Link to this property outcome: Optional\[str] Processing outcome of the submission. Link to this property

outcome\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

Link to this property requested\_by: Optional\[str] Email address of the user who requested the submission. Link to this property

requested\_disposition: Optional\[Literal\["MALICIOUS", "SUSPICIOUS", "SPOOF", 3 more]] The disposition a message is submitted to have.

Link to this property Deprecatedrequested\_ts: Optional\[str] Use requested_at instead. Deprecated, use requested_at instead. Link to this property status: Optional\[str] Processing status of the submission. Link to this property subject: Optional\[str] Subject line of the submitted message. Link to this property

type: Optional\[Literal\["Team", "User"]] Indicates whether a team member or an end user created the submission.

One of the following: "Team" Link to this property "User" Link to this property

Link to this property

[Link to this property](<#(resource)%20email_security.submissions%20%3E%20(model)%20submission_list_response%20%3E%20(schema)>) ### List reclassify submissions Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.email_security.submissions.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.submission_id) ``` 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 } } ```