Skip to content
Cloudflare API
Start here
API Reference
Email Auth

DMARC Reports

Get DMARC Report Status
email_auth.dmarc_reports.get(DMARCReportGetParams**kwargs) -> DMARCReportGetResponse
GET/zones/{zone_id}/email/auth/dmarc-reports
Configure DMARC Reports
email_auth.dmarc_reports.edit(DMARCReportEditParams**kwargs) -> DMARCReportEditResponse
PATCH/zones/{zone_id}/email/auth/dmarc-reports
ModelsExpand Collapse
class DMARCReportGetResponse: …

Response for GET/PATCH /dmarc-reports

approved_sources: Optional[List[ApprovedSource]]

List of approved sending sources (omitted when empty)

Deprecatedcreated: Optional[datetime]

Deprecated, use created_at

formatdate-time
created_at: Optional[datetime]

Creation timestamp

formatdate-time
domain: Optional[str]

The source domain

ips: Optional[List[str]]

Resolved IP addresses from SPF

Deprecatedmodified: Optional[datetime]

Deprecated, use modified_at

formatdate-time
modified_at: Optional[datetime]

Last modification timestamp

formatdate-time
name: Optional[str]

Source name (typically same as domain)

slug: Optional[str]

URL-friendly identifier

tag: Optional[str]

Source UUID

Deprecatedcreated: Optional[datetime]

Deprecated, use created_at

formatdate-time
created_at: Optional[datetime]

Creation timestamp

formatdate-time
enabled: Optional[bool]

Whether DMARC reports are enabled

Deprecatedmodified: Optional[datetime]

Deprecated, use modified_at

formatdate-time
modified_at: Optional[datetime]

Last modification timestamp

formatdate-time
records: Optional[Records]

Live DNS records for the zone, grouped by type

bimi_records: Optional[List[RecordsBimiRecord]]

BIMI TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_dkim_records: Optional[List[RecordsCnamedkimRecord]]

CNAME records for DKIM

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_dmarc_records: Optional[List[RecordsCnamedmarcRecord]]

CNAME records at _dmarc (problematic)

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_spf_records: Optional[List[RecordsCnamespfRecord]]

CNAME records for SPF

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

dkim_records: Optional[List[RecordsDKIMRecord]]

DKIM TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

dmarc_records: Optional[List[RecordsDMARCRecord]]

DMARC TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

spf_records: Optional[List[RecordsSPFRecord]]

SPF TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

rua_prefix: Optional[str]

Prefix for DMARC RUA addresses (32-char hex string)

skip_wizard: Optional[bool]

Whether to skip the setup wizard

status: Optional[Literal["missing-dmarc-report", "multiple-dmarc-reports", "missing-dmarc-rua", "cname-on-dmarc-record"]]

DMARC configuration status

One of the following:
"missing-dmarc-report"
"multiple-dmarc-reports"
"missing-dmarc-rua"
"cname-on-dmarc-record"
Deprecatedtag: Optional[str]

Use zone_id instead

zone_id: Optional[str]

Zone identifier

class DMARCReportEditResponse: …

Response for GET/PATCH /dmarc-reports

approved_sources: Optional[List[ApprovedSource]]

List of approved sending sources (omitted when empty)

Deprecatedcreated: Optional[datetime]

Deprecated, use created_at

formatdate-time
created_at: Optional[datetime]

Creation timestamp

formatdate-time
domain: Optional[str]

The source domain

ips: Optional[List[str]]

Resolved IP addresses from SPF

Deprecatedmodified: Optional[datetime]

Deprecated, use modified_at

formatdate-time
modified_at: Optional[datetime]

Last modification timestamp

formatdate-time
name: Optional[str]

Source name (typically same as domain)

slug: Optional[str]

URL-friendly identifier

tag: Optional[str]

Source UUID

Deprecatedcreated: Optional[datetime]

Deprecated, use created_at

formatdate-time
created_at: Optional[datetime]

Creation timestamp

formatdate-time
enabled: Optional[bool]

Whether DMARC reports are enabled

Deprecatedmodified: Optional[datetime]

Deprecated, use modified_at

formatdate-time
modified_at: Optional[datetime]

Last modification timestamp

formatdate-time
records: Optional[Records]

Live DNS records for the zone, grouped by type

bimi_records: Optional[List[RecordsBimiRecord]]

BIMI TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_dkim_records: Optional[List[RecordsCnamedkimRecord]]

CNAME records for DKIM

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_dmarc_records: Optional[List[RecordsCnamedmarcRecord]]

CNAME records at _dmarc (problematic)

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

cname_spf_records: Optional[List[RecordsCnamespfRecord]]

CNAME records for SPF

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

dkim_records: Optional[List[RecordsDKIMRecord]]

DKIM TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

dmarc_records: Optional[List[RecordsDMARCRecord]]

DMARC TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

spf_records: Optional[List[RecordsSPFRecord]]

SPF TXT records

id: Optional[str]

DNS record ID

content: Optional[str]

Record content

name: Optional[str]

DNS record name

ttl: Optional[int]

Time to live in seconds

type: Optional[str]

Record type

rua_prefix: Optional[str]

Prefix for DMARC RUA addresses (32-char hex string)

skip_wizard: Optional[bool]

Whether to skip the setup wizard

status: Optional[Literal["missing-dmarc-report", "multiple-dmarc-reports", "missing-dmarc-rua", "cname-on-dmarc-record"]]

DMARC configuration status

One of the following:
"missing-dmarc-report"
"multiple-dmarc-reports"
"missing-dmarc-rua"
"cname-on-dmarc-record"
Deprecatedtag: Optional[str]

Use zone_id instead

zone_id: Optional[str]

Zone identifier