--- title: List submitted abuse reports --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Abuse Reports](https://developers.cloudflare.com/api/python/resources/abuse_reports) [Submitted](https://developers.cloudflare.com/api/python/resources/abuse_reports/subresources/submitted) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List submitted abuse reports abuse\_reports.submitted.list(SubmittedListParams\*\*kwargs) -> SyncV4PagePagination\[[SubmittedListResponse]()] GET/accounts/{account\_id}/abuse-reports/submitted List abuse reports submitted by the account. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Trust and Safety Write``Trust and Safety Read` ##### ParametersExpand Collapse account\_id: str maxLength32 [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) id: Optional\[str] Filter by report code. [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20id%20%3E%20(schema)>) created\_after: Optional\[Union\[str, datetime]] Return reports submitted after this time. formatdate-time [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_after%20%3E%20(schema)>) created\_before: Optional\[Union\[str, datetime]] Return reports submitted before this time. formatdate-time [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_before%20%3E%20(schema)>) domain: Optional\[Sequence\[str]] Filter by reported domain. This parameter can be specified multiple times. [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20domain%20%3E%20(schema)>) page: Optional\[int] Page of submitted reports to return. minimum1 [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] Number of submitted reports per page. maximum200 minimum1 [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) sort: Optional\[str] A property and direction to sort by (id, cdate, domain, type, status). [Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)>)

status: Optional\[List\[Literal\["submitted", "accepted", "denied"]]] Filter by submitter-facing status. This parameter can be specified multiple times.

One of the following: "submitted" Link to this property "accepted" Link to this property "denied" Link to this property

[Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>)

type: Optional\[List\[Literal\["PHISH", "GEN", "THREAT", 6 more]]] Filter by report type. This parameter can be specified multiple times.

One of the following: "PHISH" Link to this property "GEN" Link to this property "THREAT" Link to this property "DMCA" Link to this property "EMER" Link to this property "TM" Link to this property "REG\_WHO" Link to this property "NCSEI" Link to this property "NETWORK" Link to this property

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

class SubmittedListResponse: …

reports: List\[Report]

id: str Public report code. Link to this property cdate: datetime Time the report was submitted. formatdate-time Link to this property

denial\_reason: Optional\[Literal\["unable\_to\_confirm", "incomplete\_report", "not\_on\_cloudflare", 10 more]] Submitter-safe reason for a denied report. Null when unavailable.

One of the following: "unable\_to\_confirm" Link to this property "incomplete\_report" Link to this property "not\_on\_cloudflare" Link to this property "duplicate\_report" Link to this property "content\_removed" Link to this property "report\_details\_mismatch" Link to this property "no\_abuse\_found" Link to this property "missing\_original\_work" Link to this property "direct\_url\_required" Link to this property "wrong\_report\_category" Link to this property "content\_unavailable" Link to this property "law\_enforcement\_referral\_required" Link to this property "domain\_dispute\_process\_required" Link to this property

Link to this property domain: str Domain identified in the report. Link to this property

status: Literal\["submitted", "accepted", "denied"] Status visible to the account that submitted the report.

One of the following: "submitted" Link to this property "accepted" Link to this property "denied" Link to this property

Link to this property

type: Literal\["PHISH", "GEN", "THREAT", 6 more] The abuse report type

Link to this property

submitter: Optional\[ReportSubmitter] Information about the submitter of the report.

company: Optional\[str] Link to this property email: Optional\[str] Link to this property name: Optional\[str] Link to this property telephone: Optional\[str] Link to this property

Link to this property

[Link to this property](<#(resource)%20abuse_reports.submitted%20%3E%20(model)%20submitted_list_response%20%3E%20(schema)>) ### List submitted abuse reports 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.abuse_reports.submitted.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result.items[0] print(page.reports) ``` 200 example ``` { "result": { "reports": [ { "id": "id", "cdate": "2019-12-27T18:11:19.117Z", "denial_reason": "unable_to_confirm", "domain": "domain", "status": "submitted", "type": "PHISH", "submitter": { "company": "company", "email": "email", "name": "name", "telephone": "telephone" } } ] }, "success": true, "errors": [ { "message": "message", "code": "string" } ], "messages": [ { "message": "message" } ], "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "result": { "reports": [ { "id": "id", "cdate": "2019-12-27T18:11:19.117Z", "denial_reason": "unable_to_confirm", "domain": "domain", "status": "submitted", "type": "PHISH", "submitter": { "company": "company", "email": "email", "name": "name", "telephone": "telephone" } } ] }, "success": true, "errors": [ { "message": "message", "code": "string" } ], "messages": [ { "message": "message" } ], "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 } } ```