Submitted

List submitted abuse reports

client.abuseReports.submitted.list(, ?): V4PagePagination<SubmittedListResponse { reports } >

GET/accounts/{account_id}/abuse-reports/submitted

Get a submitted abuse report

client.abuseReports.submitted.get(, , ?): SubmittedGetResponse { id, cdate, denial_reason, 25 more }

GET/accounts/{account_id}/abuse-reports/submitted/{report_id}

ModelsExpand Collapse

SubmittedListResponse { reports }

reports: Array<Report>

id: string

Public report code.

cdate: string

Time the report was submitted.

formatdate-time

denial_reason: "unable_to_confirm" | "incomplete_report" | "not_on_cloudflare" | 10 more | null

Submitter-safe reason for a denied report. Null when unavailable.

One of the following:

"unable_to_confirm"

"incomplete_report"

"not_on_cloudflare"

"duplicate_report"

"content_removed"

"report_details_mismatch"

"no_abuse_found"

"missing_original_work"

"direct_url_required"

"wrong_report_category"

"content_unavailable"

"law_enforcement_referral_required"

"domain_dispute_process_required"

domain: string

Domain identified in the report.

status: "submitted" | "accepted" | "denied"

Status visible to the account that submitted the report.

One of the following:

"submitted"

"accepted"

"denied"

type: "PHISH" | "GEN" | "THREAT" | 6 more

The abuse report type

One of the following:

"PHISH"

"GEN"

"THREAT"

"DMCA"

"EMER"

"TM"

"REG_WHO"

"NCSEI"

"NETWORK"

submitter?: Submitter { company, email, name, telephone }

Information about the submitter of the report.

company?: string

email?: string

name?: string

telephone?: string

SubmittedGetResponse { id, cdate, denial_reason, 25 more }

id: string

Public report code.

cdate: string

Time the report was submitted.

formatdate-time

denial_reason: "unable_to_confirm" | "incomplete_report" | "not_on_cloudflare" | 10 more | null

Submitter-safe reason for a denied report. Null when unavailable.

One of the following:

"unable_to_confirm"

"incomplete_report"

"not_on_cloudflare"

"duplicate_report"

"content_removed"

"report_details_mismatch"

"no_abuse_found"

"missing_original_work"

"direct_url_required"

"wrong_report_category"

"content_unavailable"

"law_enforcement_referral_required"

"domain_dispute_process_required"

domain: string

Domain identified in the report.

dsa_attestation: boolean

Whether the submitter provided the Digital Services Act attestation.

status: "submitted" | "accepted" | "denied"

Status visible to the account that submitted the report.

One of the following:

"submitted"

"accepted"

"denied"

type: "PHISH" | "GEN" | "THREAT" | 6 more

The abuse report type

One of the following:

"PHISH"

"GEN"

"THREAT"

"DMCA"

"EMER"

"TM"

"REG_WHO"

"NCSEI"

"NETWORK"

urls: Array<string>

URLs supplied with the report.

agent_name?: string

Authorized agent name supplied with the report.

comments?: string

Additional comments supplied with the report.

court?: string

The string “on” when a court proceeding applies to the report; otherwise omitted.

destination_ips?: Array<string>

Destination IP addresses supplied with a network abuse report.

host_notification?: string

Submitter preference for notifying the hosting provider.

justification?: string

Evidence supplied with the report.

ncmec_notification?: string

Submitter preference for notifying NCMEC.

ncsei_subject_representation?: boolean

Representation supplied for an NCSEI report.

original_work?: string

Original work or targeted brand supplied with the report.

owner_notification?: string

Submitter preference for notifying the content owner.

ports_protocols?: Array<string>

Ports and protocols supplied with a network abuse report.

reg_who_request?: RegWhoRequest { reg_who_good_faith_affirmation, reg_who_lawful_processing_agreement, reg_who_legal_basis, 4 more }

RDP-mandated fields for registrar WHOIS data disclosure requests.

reg_who_good_faith_affirmation: boolean

Affirmation that the request is made in good faith per RDP 10.2.4. Must be true.

reg_who_lawful_processing_agreement: boolean

Agreement to process data lawfully per RDP 10.2.5. Must be true.

reg_who_legal_basis: string

Legal rights and rationale for the request per RDP 10.2.3. Required for all WHOIS requests.

maxLength5000

reg_who_request_type: "disclosure" | "invalid_whois"

The type of WHOIS data request per RDP procedure.

One of the following:

"disclosure"

"invalid_whois"

reg_who_requested_data_elements: Array<"registrant_name" | "registrant_organization" | "registrant_email" | 14 more>

The specific WHOIS data elements being requested per RDP 10.2.2. Required for all WHOIS requests.

One of the following:

"registrant_name"

"registrant_organization"

"registrant_email"

"registrant_phone"

"registrant_address"

"registrant_address_country"

"registrant_address_postal_code"

"admin_name"

"admin_organization"

"admin_email"

"admin_phone"

"admin_address"

"tech_name"

"tech_organization"

"tech_email"

"tech_phone"

"tech_address"

reg_who_authorization_statement?: string

Optional authorization statement or power of attorney per RDP 10.2.1.3.

maxLength5000

reg_who_requestor_type?: "government" | "corporation" | "individual"

The nature of the requestor per RDP 10.2.1.2.

One of the following:

"government"

"corporation"

"individual"

reported_country?: string

Country associated with the reported activity.

reported_user_agent?: string

User agent associated with the reported activity.

source_ips?: Array<string>

Source IP addresses supplied with a network abuse report.

submitter?: Submitter { company, email, name, telephone }

Information about the submitter of the report.

company?: string

email?: string

name?: string

telephone?: string

subtypes?: Array<string>

Additional abuse classifications supplied with the report.

title?: string

Title supplied with the report.

udrp?: string

The string “on” when a UDRP proceeding applies to the report; otherwise omitted.

urs?: string

The string “on” when a URS proceeding applies to the report; otherwise omitted.

SubmittedEmails

List emails sent to an abuse report submitter

client.abuseReports.submitted.emails.list(, , ?): V4PagePagination<EmailListResponse { emails } >

GET/accounts/{account_id}/abuse-reports/submitted/{report_id}/emails

ModelsExpand Collapse

EmailListResponse { emails }

emails: Array<Email>

id: string

Unique identifier of the email.

body: string

Body content of the email.

recipient: string

Email address of the recipient.

sent_at: string

When the email was sent. Time in RFC 3339 format (https://www.rfc-editor.org/rfc/rfc3339.html)

subject: string

Subject line of the email.