--- title: List abuse reports against the account --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Abuse Reports](https://developers.cloudflare.com/api/python/resources/abuse_reports) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List abuse reports against the account abuse\_reports.list(AbuseReportListParams\*\*kwargs) -> SyncV4PagePagination\[Optional\[AbuseReportListResponse]] GET/accounts/{account\_id}/abuse-reports List abuse reports made against domains or other content associated with the account. To list reports that the account submitted, use the submitted abuse reports endpoint instead. ##### 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%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) created\_after: Optional\[str] Returns reports created after the specified date [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_after%20%3E%20(schema)>) created\_before: Optional\[str] Returns reports created before the specified date [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_before%20%3E%20(schema)>) domain: Optional\[str] Filter by domain name related to the abuse report [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20domain%20%3E%20(schema)>)

mitigation\_status: Optional\[Literal\["pending", "active", "in\_review", 2 more]] Filter reports that have any mitigations in the given status.

One of the following: "pending" Link to this property "active" Link to this property "in\_review" Link to this property "cancelled" Link to this property "removed" Link to this property

[Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20mitigation_status%20%3E%20(schema)>) page: Optional\[int] Where in pagination to start listing abuse reports [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] How many abuse reports per page to list [Link to this property](<#(resource)%20abuse_reports%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 to sort by, followed by the order (id, cdate, domain, type, status) [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)>)

status: Optional\[Literal\["accepted", "in\_review"]] Filter by the status of the report.

One of the following: "accepted" Link to this property "in\_review" Link to this property

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

type: Optional\[Literal\["PHISH", "GEN", "THREAT", 6 more]] Filter by the type of the report.

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%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class AbuseReportListResponse: …

reports: List\[Report]

id: str Public facing ID of abuse report, aka abuse\_rand. Link to this property cdate: str Creation date of report. Time in RFC 3339 format (https://www.rfc-editor.org/rfc/rfc3339.html) Link to this property domain: str Domain that relates to the report. Link to this property

mitigation\_summary: ReportMitigationSummary A summary of the mitigations related to this report.

accepted\_url\_count: int How many of the reported URLs were confirmed as abusive. Link to this property active\_count: int How many mitigations are active. Link to this property external\_host\_notified: bool Whether the report has been forwarded to an external hosting provider. Link to this property in\_review\_count: int How many mitigations are under review. Link to this property pending\_count: int How many mitigations are pending their effective date. Link to this property

Link to this property

status: Literal\["accepted", "in\_review"] An enum value that represents the status of an abuse record

One of the following: "accepted" Link to this property "in\_review" Link to this property

Link to this property

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

Link to this property justification: Optional\[str] Justification for the report. Link to this property original\_work: Optional\[str] Original work / Targeted brand in the alleged abuse. 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 urls: Optional\[List\[str]] Link to this property

Link to this property

[Link to this property](<#(resource)%20abuse_reports%20%3E%20(model)%20abuse_report_list_response%20%3E%20(schema)>) ### List abuse reports against the account 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.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result.items[0] print(page.reports) ``` 200 example ``` { "success": true, "errors": [ { "message": "message" } ], "messages": [ { "message": "message" } ], "result": { "reports": [ { "id": "id", "cdate": "2009-11-10T23:00:00Z", "domain": "domain", "mitigation_summary": { "accepted_url_count": 0, "active_count": 0, "external_host_notified": true, "in_review_count": 0, "pending_count": 0 }, "status": "accepted", "type": "PHISH", "justification": "justification", "original_work": "original_work", "submitter": { "company": "company", "email": "email", "name": "name", "telephone": "telephone" }, "urls": [ "string" ] } ] }, "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "success": true, "errors": [ { "message": "message" } ], "messages": [ { "message": "message" } ], "result": { "reports": [ { "id": "id", "cdate": "2009-11-10T23:00:00Z", "domain": "domain", "mitigation_summary": { "accepted_url_count": 0, "active_count": 0, "external_host_notified": true, "in_review_count": 0, "pending_count": 0 }, "status": "accepted", "type": "PHISH", "justification": "justification", "original_work": "original_work", "submitter": { "company": "company", "email": "email", "name": "name", "telephone": "telephone" }, "urls": [ "string" ] } ] }, "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 } } ```