--- title: Abuse Reports --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api/typescript) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # Abuse Reports ##### [Submit an abuse report](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports/methods/create) client.abuseReports.create(stringreportParam, AbuseReportCreateParamsparams, RequestOptionsoptions?): [AbuseReportCreateResponse](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports#%28resource%29%20abuse%5Freports%20%3E%20%28model%29%20abuse%5Freport%5Fcreate%5Fresponse%20%3E%20%28schema%29) POST/accounts/{account\_id}/abuse-reports/{report\_param} ##### [Abuse Report Details](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports/methods/get) client.abuseReports.get(stringreportParam, AbuseReportGetParams { account\_id } params, RequestOptionsoptions?): [AbuseReportGetResponse](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports#%28resource%29%20abuse%5Freports%20%3E%20%28model%29%20abuse%5Freport%5Fget%5Fresponse%20%3E%20%28schema%29) { id, cdate, domain, 7 more } GET/accounts/{account\_id}/abuse-reports/{report\_param} ##### [List abuse reports](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports/methods/list) client.abuseReports.list(AbuseReportListParams { account\_id, created\_after, created\_before, 7 more } params, RequestOptionsoptions?): V4PagePagination<[AbuseReportListResponse](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports#%28resource%29%20abuse%5Freports%20%3E%20%28model%29%20abuse%5Freport%5Flist%5Fresponse%20%3E%20%28schema%29) { reports } \> GET/accounts/{account\_id}/abuse-reports ##### ModelsExpand Collapse AbuseReportCreateResponse \= string The result should be ‘success’ for successful response AbuseReportGetResponse { id, cdate, domain, 7 more } id: string Public facing ID of abuse report, aka abuse\_rand. cdate: string Creation date of report. Time in RFC 3339 format () domain: string Domain that relates to the report. mitigation\_summary: MitigationSummary { accepted\_url\_count, active\_count, external\_host\_notified, 2 more } A summary of the mitigations related to this report. accepted\_url\_count: number How many of the reported URLs were confirmed as abusive. active\_count: number How many mitigations are active. external\_host\_notified: boolean Whether the report has been forwarded to an external hosting provider. in\_review\_count: number How many mitigations are under review. pending\_count: number How many mitigations are pending their effective date. status: "accepted" | "in\_review" An enum value that represents the status of an abuse record One of the following: "accepted" "in\_review" type: "PHISH" | "GEN" | "THREAT" | 6 more The abuse report type One of the following: "PHISH" "GEN" "THREAT" "DMCA" "EMER" "TM" "REG\_WHO" "NCSEI" "NETWORK" justification?: string Justification for the report. original\_work?: string Original work / Targeted brand in the alleged abuse. submitter?: Submitter { company, email, name, telephone } Information about the submitter of the report. company?: string email?: string name?: string telephone?: string urls?: Array AbuseReportListResponse { reports } reports: Array id: string Public facing ID of abuse report, aka abuse\_rand. cdate: string Creation date of report. Time in RFC 3339 format () domain: string Domain that relates to the report. mitigation\_summary: MitigationSummary { accepted\_url\_count, active\_count, external\_host\_notified, 2 more } A summary of the mitigations related to this report. accepted\_url\_count: number How many of the reported URLs were confirmed as abusive. active\_count: number How many mitigations are active. external\_host\_notified: boolean Whether the report has been forwarded to an external hosting provider. in\_review\_count: number How many mitigations are under review. pending\_count: number How many mitigations are pending their effective date. status: "accepted" | "in\_review" An enum value that represents the status of an abuse record One of the following: "accepted" "in\_review" type: "PHISH" | "GEN" | "THREAT" | 6 more The abuse report type One of the following: "PHISH" "GEN" "THREAT" "DMCA" "EMER" "TM" "REG\_WHO" "NCSEI" "NETWORK" justification?: string Justification for the report. original\_work?: string Original work / Targeted brand in the alleged abuse. submitter?: Submitter { company, email, name, telephone } Information about the submitter of the report. company?: string email?: string name?: string telephone?: string urls?: Array #### Abuse ReportsMitigations ##### [List abuse report mitigations](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports/subresources/mitigations/methods/list) client.abuseReports.mitigations.list(stringreportID, MitigationListParams { account\_id, effective\_after, effective\_before, 6 more } params, RequestOptionsoptions?): V4PagePagination<[MitigationListResponse](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports#%28resource%29%20abuse%5Freports.mitigations%20%3E%20%28model%29%20mitigation%5Flist%5Fresponse%20%3E%20%28schema%29) { mitigations } \> GET/accounts/{account\_id}/abuse-reports/{report\_id}/mitigations ##### [Request review on mitigations](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports/subresources/mitigations/methods/review) client.abuseReports.mitigations.review(stringreportID, MitigationReviewParams { account\_id, appeals, data, type } params, RequestOptionsoptions?): SinglePage<[MitigationReviewResponse](https://developers.cloudflare.com/api/typescript/resources/abuse%5Freports#%28resource%29%20abuse%5Freports.mitigations%20%3E%20%28model%29%20mitigation%5Freview%5Fresponse%20%3E%20%28schema%29) { id, effective\_date, entity\_id, 3 more } \> POST/accounts/{account\_id}/abuse-reports/{report\_id}/mitigations/appeal ##### ModelsExpand Collapse MitigationListResponse { mitigations } mitigations: Array id: string ID of remediation. effective\_date: string Date when the mitigation will become active. Time in RFC 3339 format () entity\_id: string entity\_type: "url\_pattern" | "account" | "zone" | "custom\_expression" The type of entity targeted by a mitigation. One of the following: "url\_pattern" "account" "zone" "custom\_expression" status: "pending" | "active" | "in\_review" | 2 more The status of a mitigation One of the following: "pending" "active" "in\_review" "cancelled" "removed" type: string The type of mitigation applied to a reported entity. MitigationReviewResponse { id, effective\_date, entity\_id, 3 more } id: string ID of remediation. effective\_date: string Date when the mitigation will become active. Time in RFC 3339 format () entity\_id: string entity\_type: "url\_pattern" | "account" | "zone" | "custom\_expression" The type of entity targeted by a mitigation. One of the following: "url\_pattern" "account" "zone" "custom\_expression" status: "pending" | "active" | "in\_review" | 2 more The status of a mitigation One of the following: "pending" "active" "in\_review" "cancelled" "removed" type: string The type of mitigation applied to a reported entity.