---
title: List abuse report mitigations
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Abuse Reports](https://developers.cloudflare.com/api/python/resources/abuse_reports)

[Mitigations](https://developers.cloudflare.com/api/python/resources/abuse_reports/subresources/mitigations)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# List abuse report mitigations

abuse\_reports.mitigations.list(strreport\_id, MitigationListParams\*\*kwargs) -> SyncV4PagePagination\[Optional\[MitigationListResponse]]

GET/accounts/{account\_id}/abuse-reports/{report\_id}/mitigations

List mitigations done to remediate the abuse report.

##### 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.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)

report\_id: str

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

effective\_after: Optional\[str]

Returns mitigation that were dispatched after the given date

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

effective\_before: Optional\[str]

Returns mitigations that were dispatched before the given date

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

<details>

<summary>

entity\_type: Optional\[Literal\["url\_pattern", "account", "zone", "custom\_expression"]]

Filter by the type of entity the mitigation impacts.

</summary>

One of the following:

"url\_pattern"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20entity_type%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"account"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20entity_type%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

"zone"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20entity_type%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

"custom\_expression"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20entity_type%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

</details>

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

page: Optional\[int]

Where in pagination to start listing abuse reports

[Link to this property](<#(resource)%20abuse_reports.mitigations%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.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)

<details>

<summary>

sort: Optional\[Literal\["type,asc", "type,desc", "effective\_date,asc", 5 more]]

A property to sort by, followed by the order

</summary>

One of the following:

"type,asc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"type,desc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

"effective\_date,asc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

"effective\_date,desc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

"status,asc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%204">Link to this property</a>

"status,desc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%205">Link to this property</a>

"entity\_type,asc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%206">Link to this property</a>

"entity\_type,desc"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort%20%3E%20(schema)%20%3E%20(member)%207">Link to this property</a>

</details>

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

<details>

<summary>

status: Optional\[Literal\["pending", "active", "in\_review", 2 more]]

Filter by the status of the mitigation.

</summary>

One of the following:

"pending"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(member)%200">Link to this property</a>

"active"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(member)%201">Link to this property</a>

"in\_review"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(member)%202">Link to this property</a>

"cancelled"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(member)%203">Link to this property</a>

"removed"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)%20%3E%20(member)%204">Link to this property</a>

</details>

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

type: Optional\[str]

Filter by the type of mitigation. This filter parameter can be specified multiple times to include multiple types of mitigations in the result set.

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

##### ReturnsExpand Collapse

<details>

<summary>

class MitigationListResponse: …

</summary>

<details>

<summary>

mitigations: List\[Mitigation]

</summary>

id: str

ID of remediation.

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20id">Link to this property</a>

effective\_date: str

Date when the mitigation will become active. Time in RFC 3339 format (<a href="https://www.rfc-editor.org/rfc/rfc3339.html">https://www.rfc-editor.org/rfc/rfc3339.html</a>)

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20effective_date">Link to this property</a>

entity\_id: str

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_id">Link to this property</a>

<details>

<summary>

entity\_type: Literal\["url\_pattern", "account", "zone", "custom\_expression"]

The type of entity targeted by a mitigation.

</summary>

One of the following:

"url\_pattern"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_type%20%3E%20(member)%200">Link to this property</a>

"account"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_type%20%3E%20(member)%201">Link to this property</a>

"zone"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_type%20%3E%20(member)%202">Link to this property</a>

"custom\_expression"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_type%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20entity_type">Link to this property</a>

<details>

<summary>

status: Literal\["pending", "active", "in\_review", 2 more]

The status of a mitigation

</summary>

One of the following:

"pending"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

"active"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

"in\_review"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

"cancelled"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

"removed"

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20status">Link to this property</a>

type: str

The type of mitigation applied to a reported entity.

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations%20%3E%20(items)%20%3E%20(property)%20type">Link to this property</a>

</details>

<a href="#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)%20%3E%20(property)%20mitigations">Link to this property</a>

</details>

[Link to this property](<#(resource)%20abuse_reports.mitigations%20%3E%20(model)%20mitigation_list_response%20%3E%20(schema)>)

### List abuse report mitigations

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.mitigations.list(
    report_id="report_id",
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
)
page = page.result.items[0]
print(page.mitigations)
```

200 example

```
{
  "success": true,
  "errors": [
    {
      "message": "message"
    }
  ],
  "messages": [
    {
      "message": "message"
    }
  ],
  "result": {
    "mitigations": [
      {
        "id": "id",
        "effective_date": "2009-11-10T23:00:00Z",
        "entity_id": "entity_id",
        "entity_type": "url_pattern",
        "status": "pending",
        "type": "type"
      }
    ]
  },
  "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": {
    "mitigations": [
      {
        "id": "id",
        "effective_date": "2009-11-10T23:00:00Z",
        "entity_id": "entity_id",
        "entity_type": "url_pattern",
        "status": "pending",
        "type": "type"
      }
    ]
  },
  "result_info": {
    "count": 0,
    "page": 0,
    "per_page": 0,
    "total_count": 0,
    "total_pages": 0
  }
}
```