Cloudflare API | Abuse Reports › List Abuse Reports

API Reference

Overview

Account & User Management

Abuse Reports

Submit an abuse report

Certificate Management

ACM

Certificate Authorities

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

SSL

Cloudflare One

Email Security

Zero Trust

DNS

Account Custom Nameservers

DNS

DNS Firewall

Domain/Zone Management

IP Addresses

Media

Networking

Magic Cloud Networking

Magic Network Monitoring

Magic Transit

Network Interconnects

Observability

Radar

Routing & Performance

Rules

Security

Leaked Credential Checks

Storage & Databases

Threat Intelligence

Workers & Pages

Workers For Platforms

Shared

Abuse Reports

abuse_reports

Methods

Submit An Abuse Report -> Envelope<string>

post/accounts/{account_id}/abuse-reports/{report_param}

Submit the Abuse Report of a particular type

Abuse Report Details -> Envelope<{ id, cdate, domain, 7 more... }>

get/accounts/{account_id}/abuse-reports/{report_param}

Retrieve the details of an abuse report.

List Abuse Reports -> V4PagePagination<{ reports }>

get/accounts/{account_id}/abuse-reports

List the abuse reports for a given account

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Trust and Safety Write Trust and Safety Read

path Parameters

account_id: string

(maxLength: 32)

query Parameters

created_after: string

Optional

Returns reports created after the specified date

created_before: string

Optional

Returns reports created before the specified date

domain: string

Optional

Filter by domain name related to the abuse report

mitigation_status:

Optional

Filter reports that have any mitigations in the given status.

"pending"

"active"

"in_review"

"cancelled"

"removed"

page: number

Optional

Where in pagination to start listing abuse reports

per_page: number

Optional

How many abuse reports per page to list

sort: string

Optional

A property to sort by, followed by the order (id, cdate, domain, type, status)

status:

Optional

Filter by the status of the report.

"accepted"

"in_review"

type:

Optional

Filter by the type of the report.

"PHISH"

"GEN"

"THREAT"

"DMCA"

"EMER"

"TM"

"REG_WHO"

"NCSEI"

"NETWORK"

Response fields

success: boolean

errors: Array<{ message }>

Optional

messages: Array<{ message }>

Optional

result: { reports }

Optional

result_info: { count, page, per_page, 2 more... }

Optional

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/abuse-reports \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

200Example

{
  "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
  }
}

Abuse Reports

Mitigations

abuse_reports.mitigations

Methods

List Abuse Report Mitigations -> V4PagePagination<{ mitigations }>

get/accounts/{account_id}/abuse-reports/{report_id}/mitigations

List mitigations done to remediate the abuse report.

Request Review On Mitigations -> SinglePage<{ id, effective_date, entity_id, 3 more... }>

post/accounts/{account_id}/abuse-reports/{report_id}/mitigations/appeal

Request a review for mitigations on an account.