--- title: List abuse reports against the account --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Abuse Reports](https://developers.cloudflare.com/api/go/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 client.AbuseReports.List(ctx, params) (\*V4PagePagination\[[AbuseReportListResponse]()], error) 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
params AbuseReportListParams AccountID param.Field\[string] Path param: Cloudflare Account ID maxLength32 Link to this property CreatedAfter param.Field\[string]Optional Query param: Returns reports created after the specified date Link to this property CreatedBefore param.Field\[string]Optional Query param: Returns reports created before the specified date Link to this property Domain param.Field\[string]Optional Query param: Filter by domain name related to the abuse report Link to this property
MitigationStatus param.Field\[AbuseReportListParamsMitigationStatus]Optional Query param: Filter reports that have any mitigations in the given status. const AbuseReportListParamsMitigationStatusPending AbuseReportListParamsMitigationStatus = "pending" Link to this property const AbuseReportListParamsMitigationStatusActive AbuseReportListParamsMitigationStatus = "active" Link to this property const AbuseReportListParamsMitigationStatusInReview AbuseReportListParamsMitigationStatus = "in\_review" Link to this property const AbuseReportListParamsMitigationStatusCancelled AbuseReportListParamsMitigationStatus = "cancelled" Link to this property const AbuseReportListParamsMitigationStatusRemoved AbuseReportListParamsMitigationStatus = "removed" Link to this property
Link to this property Page param.Field\[int64]Optional Query param: Where in pagination to start listing abuse reports Link to this property PerPage param.Field\[int64]Optional Query param: How many abuse reports per page to list Link to this property Sort param.Field\[string]Optional Query param: A property to sort by, followed by the order (id, cdate, domain, type, status) Link to this property
Status param.Field\[AbuseReportListParamsStatus]Optional Query param: Filter by the status of the report. const AbuseReportListParamsStatusAccepted AbuseReportListParamsStatus = "accepted" Link to this property const AbuseReportListParamsStatusInReview AbuseReportListParamsStatus = "in\_review" Link to this property
Link to this property
Type param.Field\[AbuseReportListParamsType]Optional Query param: Filter by the type of the report. const AbuseReportListParamsTypePhish AbuseReportListParamsType = "PHISH" Link to this property const AbuseReportListParamsTypeGen AbuseReportListParamsType = "GEN" Link to this property const AbuseReportListParamsTypeThreat AbuseReportListParamsType = "THREAT" Link to this property const AbuseReportListParamsTypeDmca AbuseReportListParamsType = "DMCA" Link to this property const AbuseReportListParamsTypeEmer AbuseReportListParamsType = "EMER" Link to this property const AbuseReportListParamsTypeTm AbuseReportListParamsType = "TM" Link to this property const AbuseReportListParamsTypeRegWho AbuseReportListParamsType = "REG\_WHO" Link to this property const AbuseReportListParamsTypeNcsei AbuseReportListParamsType = "NCSEI" Link to this property const AbuseReportListParamsTypeNetwork AbuseReportListParamsType = "NETWORK" Link to this property
Link to this property
[Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type AbuseReportListResponse struct{…}
Reports \[]AbuseReportListResponseReport ID string Public facing ID of abuse report, aka abuse\_rand. Link to this property Cdate string Creation date of report. Time in RFC 3339 format (https://www.rfc-editor.org/rfc/rfc3339.html) Link to this property Domain string Domain that relates to the report. Link to this property
MitigationSummary AbuseReportListResponseReportsMitigationSummary A summary of the mitigations related to this report. AcceptedURLCount int64 How many of the reported URLs were confirmed as abusive. Link to this property ActiveCount int64 How many mitigations are active. Link to this property ExternalHostNotified bool Whether the report has been forwarded to an external hosting provider. Link to this property InReviewCount int64 How many mitigations are under review. Link to this property PendingCount int64 How many mitigations are pending their effective date. Link to this property
Link to this property
Status AbuseReportListResponseReportsStatus An enum value that represents the status of an abuse record One of the following: const AbuseReportListResponseReportsStatusAccepted AbuseReportListResponseReportsStatus = "accepted" Link to this property const AbuseReportListResponseReportsStatusInReview AbuseReportListResponseReportsStatus = "in\_review" Link to this property
Link to this property
Type AbuseReportListResponseReportsType The abuse report type One of the following: const AbuseReportListResponseReportsTypePhish AbuseReportListResponseReportsType = "PHISH" Link to this property const AbuseReportListResponseReportsTypeGen AbuseReportListResponseReportsType = "GEN" Link to this property const AbuseReportListResponseReportsTypeThreat AbuseReportListResponseReportsType = "THREAT" Link to this property const AbuseReportListResponseReportsTypeDmca AbuseReportListResponseReportsType = "DMCA" Link to this property const AbuseReportListResponseReportsTypeEmer AbuseReportListResponseReportsType = "EMER" Link to this property const AbuseReportListResponseReportsTypeTm AbuseReportListResponseReportsType = "TM" Link to this property const AbuseReportListResponseReportsTypeRegWho AbuseReportListResponseReportsType = "REG\_WHO" Link to this property const AbuseReportListResponseReportsTypeNcsei AbuseReportListResponseReportsType = "NCSEI" Link to this property const AbuseReportListResponseReportsTypeNetwork AbuseReportListResponseReportsType = "NETWORK" Link to this property
Link to this property Justification stringOptional Justification for the report. Link to this property OriginalWork stringOptional Original work / Targeted brand in the alleged abuse. Link to this property
Submitter AbuseReportListResponseReportsSubmitterOptional Information about the submitter of the report. Company stringOptional Link to this property Email stringOptional Link to this property Name stringOptional Link to this property Telephone stringOptional Link to this property
Link to this property URLs \[]stringOptional Link to this property
Link to this property
[Link to this property](<#(resource)%20abuse_reports%20%3E%20(model)%20AbuseReportListResponse%20%3E%20(schema)>) ### List abuse reports against the account Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/abuse_reports" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.AbuseReports.List(context.TODO(), abuse_reports.AbuseReportListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```