---
title: Submit an abuse report
---

[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**

# Submit an abuse report

client.AbuseReports.New(ctx, reportParam, params) (\*string, error)

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

reportParam string

The report type for submitted reports.

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

<details>

<summary>

params AbuseReportNewParams

</summary>

AccountID param.Field\[string]

Path param: Cloudflare Account ID

maxLength32

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20account_id">Link to this property</a>

<details>

<summary>

Act param.Field\[<a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20act%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportAct</a>]

Body param: The report type for submitted reports.

</summary>

const AbuseReportNewParamsAbuseReportsDmcaReportActAbuseDmca <a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20act%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportAct</a> = "abuse\_dmca"

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20act%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20act">Link to this property</a>

Address1 param.Field\[string]

Body param: Text not exceeding 100 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength100

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20address1">Link to this property</a>

AgentName param.Field\[string]

Body param: 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 (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength60

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agent_name">Link to this property</a>

<details>

<summary>

Agree param.Field\[<a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agree%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportAgree</a>]

Body param: Can be <code>0</code> for false or <code>1</code> for true. Must be value: 1 for DMCA reports

</summary>

const AbuseReportNewParamsAbuseReportsDmcaReportAgree1 <a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agree%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportAgree</a> = 1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agree%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20agree">Link to this property</a>

City param.Field\[string]

Body param: Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20city">Link to this property</a>

Country param.Field\[string]

Body param: Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20country">Link to this property</a>

Email param.Field\[string]

Body param: A valid email of the abuse reporter. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20email">Link to this property</a>

Email2 param.Field\[string]

Body param: Should match the value provided in <code>email</code>

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20email2">Link to this property</a>

<details>

<summary>

HostNotification param.Field\[<a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20host_notification%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportHostNotification</a>]

Body param: Notification type based on the abuse type. NOTE: Copyright (DMCA) and Trademark reports cannot be anonymous.

</summary>

const AbuseReportNewParamsAbuseReportsDmcaReportHostNotificationSend <a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20host_notification%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportHostNotification</a> = "send"

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20host_notification%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20host_notification">Link to this property</a>

Name param.Field\[string]

Body param: Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20name">Link to this property</a>

OriginalWork param.Field\[string]

Body param: Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20original_work">Link to this property</a>

<details>

<summary>

OwnerNotification param.Field\[<a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20owner_notification%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportOwnerNotification</a>]

Body param: Notification type based on the abuse type. NOTE: Copyright (DMCA) and Trademark reports cannot be anonymous.

</summary>

const AbuseReportNewParamsAbuseReportsDmcaReportOwnerNotificationSend <a href="https://developers.cloudflare.com/api/go/resources/abuse_reports/methods/create#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20owner_notification%20%3E%20(schema)">AbuseReportNewParamsAbuseReportsDmcaReportOwnerNotification</a> = "send"

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20owner_notification%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20owner_notification">Link to this property</a>

Signature param.Field\[string]

Body param: 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

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20signature">Link to this property</a>

State param.Field\[string]

Body param: Text not exceeding 255 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20state">Link to this property</a>

URLs param.Field\[string]

Body param: 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 (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20urls">Link to this property</a>

Comments param.Field\[string]Optional

Body param: Any additional comments about the infringement not exceeding 2000 characters

maxLength2000

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20comments">Link to this property</a>

Company param.Field\[string]Optional

Body param: Text not exceeding 100 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength100

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20company">Link to this property</a>

ReportedCountry param.Field\[string]Optional

Body param: Text containing 2 characters

maxLength2

minLength2

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20reported_country">Link to this property</a>

ReportedUserAgent param.Field\[string]Optional

Body param: Text not exceeding 255 characters

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20reported_user_agent">Link to this property</a>

Tele param.Field\[string]Optional

Body param: Text not exceeding 20 characters. This field may be released by Cloudflare to third parties such as the Lumen Database (<a href="https://lumendatabase.org/">https://lumendatabase.org/</a>).

maxLength20

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20tele">Link to this property</a>

Title param.Field\[string]Optional

Body param: Text not exceeding 255 characters

maxLength255

minLength1

<a href="#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20title">Link to this property</a>

</details>

[Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(params)%200>)

##### ReturnsExpand Collapse

type AbuseReportNewResponseEnvelopeResult string

The result should be ‘success’ for successful response

[Link to this property](<#(resource)%20abuse_reports%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

### Submit an abuse report

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"),
  )
  abuseReport, err := client.AbuseReports.New(
    context.TODO(),
    "report_param",
    abuse_reports.AbuseReportNewParams{
      AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
      Body: abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReport{
        Act: cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportActAbuseDmca),
        Address1: cloudflare.F("x"),
        AgentName: cloudflare.F("x"),
        Agree: cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportAgree1),
        City: cloudflare.F("x"),
        Country: cloudflare.F("x"),
        Email: cloudflare.F("email"),
        Email2: cloudflare.F("email2"),
        HostNotification: cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportHostNotificationSend),
        Name: cloudflare.F("x"),
        OriginalWork: cloudflare.F("x"),
        OwnerNotification: cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportOwnerNotificationSend),
        Signature: cloudflare.F("signature"),
        State: cloudflare.F("x"),
        URLs: cloudflare.F("urls"),
      },
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", abuseReport)
}
```

200 example

```
{
  "abuse_rand": "abuse_rand",
  "request": {
    "act": "act"
  },
  "result": "result"
}
```

##### Returns Examples

200 example

```
{
  "abuse_rand": "abuse_rand",
  "request": {
    "act": "act"
  },
  "result": "result"
}
```