--- title: Submit an abuse report --- [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** # Submit an abuse report abuse\_reports.create(strreport\_param, AbuseReportCreateParams\*\*kwargs) -> [AbuseReportCreateResponse]() POST/accounts/{account\_id}/abuse-reports/{report\_param} Submit an abuse report of a particular type. Requires the abuse-reports entitlement on the account (Enterprise accounts have it by default; other accounts must request access) and an API token with the `Trust and Safety Write` permission. If the account is not entitled, the request is rejected with an HTTP `401` response (see below). ##### 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` ##### ParametersExpand Collapse account\_id: str maxLength32 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20account_id%20%3E%20(schema)>) report\_param: str The report type for submitted reports. [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20report_param%20%3E%20(schema)>) act: Literal\["abuse\_dmca"] The report type for submitted reports. [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20act%20%3E%20(schema)>) address1: str Text not exceeding 100 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength100 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20address1%20%3E%20(schema)>) agent\_name: str The name of the copyright holder. Text not exceeding 60 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength60 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agent_name%20%3E%20(schema)>) agree: Literal\[1] Can be `0` for false or `1` for true. Must be value: 1 for DMCA reports [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agree%20%3E%20(schema)>) city: str Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20city%20%3E%20(schema)>) country: str Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20country%20%3E%20(schema)>) email: str A valid email of the abuse reporter. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20email%20%3E%20(schema)>) email2: str Should match the value provided in `email` [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20email2%20%3E%20(schema)>) host\_notification: Literal\["send"] Notification type based on the abuse type. NOTE: Copyright (DMCA) and Trademark reports cannot be anonymous. [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20host_notification%20%3E%20(schema)>) name: str Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>) original\_work: str Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20original_work%20%3E%20(schema)>) owner\_notification: Literal\["send"] Notification type based on the abuse type. NOTE: Copyright (DMCA) and Trademark reports cannot be anonymous. [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20owner_notification%20%3E%20(schema)>) signature: str Required for DMCA reports, should be same as Name. An affirmation that all information in the report is true and accurate while agreeing to the policies of Cloudflare’s abuse reports [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20signature%20%3E%20(schema)>) state: str Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20state%20%3E%20(schema)>) urls: str A list of valid URLs separated by ‘\\n’ (new line character). The list of the URLs should not exceed 250 URLs. All URLs should have the same hostname. Each URL should be unique. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20urls%20%3E%20(schema)>) comments: Optional\[str] Any additional comments about the infringement not exceeding 2000 characters maxLength2000 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20comments%20%3E%20(schema)>) company: Optional\[str] Text not exceeding 100 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength100 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20company%20%3E%20(schema)>) reported\_country: Optional\[str] Text containing 2 characters maxLength2 minLength2 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20reported_country%20%3E%20(schema)>) reported\_user\_agent: Optional\[str] Text not exceeding 255 characters maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20reported_user_agent%20%3E%20(schema)>) tele: Optional\[str] Text not exceeding 20 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (https://lumendatabase.org/). maxLength20 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20tele%20%3E%20(schema)>) title: Optional\[str] Text not exceeding 255 characters maxLength255 minLength1 [Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20title%20%3E%20(schema)>) ##### ReturnsExpand Collapse str The result should be ‘success’ for successful response [Link to this property](<#(resource)%20abuse_reports%20%3E%20(model)%20abuse_report_create_response%20%3E%20(schema)>) ### Submit an abuse report 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 ) abuse_report = client.abuse_reports.create( report_param="report_param", account_id="023e105f4ecef8ad9ca31a8372d0c353", act="abuse_dmca", address1="x", agent_name="x", agree=1, city="x", country="x", email="email", email2="email2", host_notification="send", name="x", original_work="x", owner_notification="send", signature="signature", state="x", urls="urls", ) print(abuse_report) ``` 200 example ``` { "abuse_rand": "abuse_rand", "request": { "act": "act" }, "result": "result" } ``` ##### Returns Examples 200 example ``` { "abuse_rand": "abuse_rand", "request": { "act": "act" }, "result": "result" } ```