DMARC reporty
Čtěte souhrnné a forenzní DMARC reporty odesílací domény, nebo nahrajte vlastní.
- GET/domains/{id}/dmarc/reports
- GET/domains/{id}/dmarc/reports/{report_id}
- POST/domains/{id}/dmarc/reports
- GET/domains/{id}/dmarc/forensic
- GET/domains/{id}/dmarc/forensic/{report_id}
- GET/domains/{id}/dmarc/stats
- GET/domains/{id}/dmarc/sources
- GET/domains/{id}/dmarc/countries
- GET/domains/{id}/dmarc/asns
- GET/domains/{id}/dmarc/reporters
Výpis souhrnných reportů
Vrací DMARC reporty odesílací domény od nejnovějších. Vyžaduje API klíč s oprávněním full.
Emailit sbírá reporty jen u domén se zapnutými DMARC reporty (dmarc_reports: true v endpointu Úprava domény), což vyžaduje tarif Pro nebo vyšší. Viz Čtení DMARC reportů.
Seznam obsahuje i forenzní reporty. Pokud chcete vypsat jen souhrnné reporty, předejte type=aggregate; podrobnosti forenzních reportů získáte endpointem Výpis forenzních reportů.
/domains/{id}/dmarc/reportsParametry v cestě
idstringpovinnédom_…), nebo název domény, například acme.com.Parametry dotazu
typestringaggregate, nebo forensic.statusstringpending, processed, failed nebo duplicate.org_namestringgoogle.com.fromstring2026-09-01.tostringlimitintegervýchozí: 25offsetintegervýchozí: 0matchstringHodnota all (výchozí) vyžaduje shodu se všemi filtry. S hodnotou or stačí shoda s kterýmkoli filtrem. Viz Filtrování.
orderstringKlíč řazení pro tento výpis. Viz klíče řazení níže.
directionstringasc, nebo desc.
Obecné filtry key.condition=value fungují také u type, status, org_name a created_at; to jsou zároveň klíče řazení pro order. Viz Filtrování a řazení.
Odpověď
Vrací data, pole objektů reportů, a meta s total, limit a offset.
idstringdmr_.typestring | nullaggregate, nebo forensic. U nahraného reportu null, dokud se nezpracuje.sourcestringsmtp u reportů, které Emailit přijal na adresu domény pro reporty, upload u reportů, které jste nahráli.statusstringpending, processed, failed (viz error_message) nebo duplicate (stejný report už byl zpracován).org_name, org_emailstring | nullexternal_report_idstring | nulldate_range_begin, date_range_endstring | nullpolicy_domain, adkim, aspf, p, sp, pct, fostring | integer | nullr, nebo s), politika a politika pro subdomény (none, quarantine, reject), procento a volby pro hlášení selhání.original_filenamestring | nullenvelope_tostring | nullcreated_at, updated_at, processed_atstring | nullPokud doména ve workspace neexistuje, vrací 404.
{
"data": [
{
"object": "dmarc_report",
"id": "dmr_3Xu63kEs8KCiyOZ1TDgnttppitx",
"type": "aggregate",
"source": "smtp",
"status": "processed",
"org_name": "google.com",
"org_email": "noreply-dmarc-support@google.com",
"external_report_id": "4129847120347812934",
"date_range_begin": "2026-09-29 00:00:00+00",
"date_range_end": "2026-09-29 23:59:59+00",
"policy_domain": "acme.com",
"adkim": "r",
"aspf": "r",
"p": "none",
"sp": "none",
"pct": 100,
"fo": null,
"original_filename": null,
"error_message": null,
"envelope_to": "k2v9x4qa7m@dmarc.emailitmail.com",
"created_at": "2026-09-30 04:12:09.214377+00",
"updated_at": "2026-09-30 04:12:11.902154+00",
"processed_at": "2026-09-30 04:12:11.902154+00"
}
],
"meta": { "total": 1, "limit": 50, "offset": 0 }
}{
"error": "Domain not found"
}Načtení reportu
Načte jeden DMARC report. U souhrnného reportu obsahuje odpověď jeho záznamy, jeden pro každý odesílací zdroj, seřazené podle počtu zpráv. U forenzního reportu obsahuje ukázku selhání v poli forensic. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/reports/{report_id}Parametry v cestě
idstringpovinnédom_…), nebo název domény.report_idstringpovinnédmr_…).Parametry dotazu
limitintegervýchozí: 100offsetintegervýchozí: 0Odpověď
Vrací objekt reportu (viz Výpis souhrnných reportů) a navíc:
recordsobject[]metaobjecttotal, limit a offset.forensicobject | nullKaždý záznam obsahuje:
source_ipstringcountintegercountry_code, country_name, continent_code, asn, as_org, latitude, longitudestring | integer | number | nullnull, když se IP adresu nepodařilo lokalizovat.dispositionstringnone, quarantine nebo reject.dkim, spfstringpass, nebo fail.header_from, envelope_from, envelope_tostring | nulldkim_domain, dkim_selector, dkim_resultstring | nullspf_domain, spf_resultstring | nullreason_type, reason_commentstring | nullforwarded nebo mailing_list.Pokud doména nebo report neexistuje, vrací 404.
{
"object": "dmarc_report",
"id": "dmr_3Xu63kEs8KCiyOZ1TDgnttppitx",
"type": "aggregate",
"source": "smtp",
"status": "processed",
"org_name": "google.com",
"org_email": "noreply-dmarc-support@google.com",
"external_report_id": "4129847120347812934",
"date_range_begin": "2026-09-29 00:00:00+00",
"date_range_end": "2026-09-29 23:59:59+00",
"policy_domain": "acme.com",
"adkim": "r",
"aspf": "r",
"p": "none",
"sp": "none",
"pct": 100,
"fo": null,
"original_filename": null,
"error_message": null,
"envelope_to": "k2v9x4qa7m@dmarc.emailitmail.com",
"created_at": "2026-09-30 04:12:09.214377+00",
"updated_at": "2026-09-30 04:12:11.902154+00",
"processed_at": "2026-09-30 04:12:11.902154+00",
"records": [
{
"object": "dmarc_report_record",
"source_ip": "198.51.100.24",
"count": 1840,
"country_code": "US",
"country_name": "United States",
"continent_code": "NA",
"asn": 64500,
"as_org": "Example Hosting",
"latitude": 37.751,
"longitude": -97.822,
"disposition": "none",
"dkim": "pass",
"spf": "pass",
"header_from": "acme.com",
"envelope_from": "emailit.acme.com",
"envelope_to": null,
"dkim_domain": "acme.com",
"dkim_selector": "emailit",
"dkim_result": "pass",
"spf_domain": "emailit.acme.com",
"spf_result": "pass",
"reason_type": null,
"reason_comment": null
},
{
"object": "dmarc_report_record",
"source_ip": "203.0.113.77",
"count": 12,
"country_code": "NL",
"country_name": "Netherlands",
"continent_code": "EU",
"asn": 64511,
"as_org": "Example Networks",
"latitude": 52.3824,
"longitude": 4.8995,
"disposition": "none",
"dkim": "fail",
"spf": "fail",
"header_from": "acme.com",
"envelope_from": "acme.com",
"envelope_to": null,
"dkim_domain": null,
"dkim_selector": null,
"dkim_result": null,
"spf_domain": "acme.com",
"spf_result": "softfail",
"reason_type": null,
"reason_comment": null
}
],
"meta": { "total": 2, "limit": 100, "offset": 0 }
}{
"error": "Report not found"
}Nahrání reportu
Nahraje DMARC report, který jste dostali jinde, například do schránky, kterou jste používali před Emailitem. Vyžaduje API klíč s oprávněním full.
Emailit soubor uloží a zpracuje ho na pozadí: odpověď má stav pending a report brzy potom přejde do stavu processed, failed nebo duplicate (už naimportovaný). Zkontrolujete ho endpointem Načtení reportu. Reporty, které Emailit přijímá e-mailem, vyžadují u domény zapnuté DMARC reporty (tarif Pro nebo vyšší); nahrané reporty se zpracují v každém případě.
/domains/{id}/dmarc/reportsParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry v těle požadavku
Pošlete právě jeden z parametrů content_base64 a content. Dekódovaný report může mít nejvýše 10 MB.
content_base64string.xml, .xml.gz nebo .zip a forenzní reporty jako .eml (AFRF).contentstringfilenamestringoriginal_filename.Odpověď
Vrací 202 Accepted s novým objektem reportu. type je null, dokud ho zpracování nerozpozná.
| Stavový kód | Kdy |
|---|---|
400 |
Není nastavený ani content_base64, ani content, nebo je hodnota prázdná. |
404 |
Doména ve workspace neexistuje. |
413 |
Dekódovaný report je větší než 10 MB. |
{
"object": "dmarc_report",
"id": "dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk",
"type": null,
"source": "upload",
"status": "pending",
"org_name": null,
"org_email": null,
"external_report_id": null,
"date_range_begin": null,
"date_range_end": null,
"policy_domain": null,
"adkim": null,
"aspf": null,
"p": null,
"sp": null,
"pct": null,
"fo": null,
"original_filename": "google-acme.com-2026-09-29.xml.gz",
"error_message": null,
"envelope_to": null,
"created_at": "2026-10-01 12:03:55.607+00",
"updated_at": "2026-10-01 12:03:55.607+00",
"processed_at": null
}{
"error": "content_base64 or content is required"
}{
"error": "Report exceeds maximum size of 10485760 bytes"
}Výpis forenzních reportů
Vrací zpracované forenzní (RUF) reporty domény od nejnovějších. Každý popisuje jednu zprávu, která neprošla kontrolou DMARC. Seznam neobsahuje hlavičky; uvidíte je, když načtete forenzní report. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší. Forenzní reporty posílá jen málo poskytovatelů schránek a ti, kteří je posílají, do nich mohou zahrnout osobní údaje z neúspěšné zprávy.
/domains/{id}/dmarc/forensicParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstringtostringlimitintegervýchozí: 25offsetintegervýchozí: 0Obecné filtry key.condition=value fungují také u org_name a created_at, spolu s match, order a direction. Viz Filtrování a řazení.
Odpověď
Vrací data a meta (total, limit, offset). Každá položka obsahuje:
objectstringdmarc_forensic_report.id, report_idstringdmr_…).arrival_datestring | nullsource_ipstring | nullcountry_code, country_name, continent_code, asn, as_org, latitude, longitudestring | integer | number | nullauth_failurestring | nulldmarc, spf nebo dkim.authentication_resultsstring | nullAuthentication-Results od přijímajícího serveru.original_mail_from, original_rcpt_to, subjectstring | nulldelivery_resultstring | nullreject nebo delivered.reported_domainstring | nullcreated_atstring | null{
"data": [
{
"object": "dmarc_forensic_report",
"id": "dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk",
"report_id": "dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk",
"arrival_date": "2026-09-28 17:44:02+00",
"source_ip": "203.0.113.77",
"country_code": "NL",
"country_name": "Netherlands",
"continent_code": "EU",
"asn": 64511,
"as_org": "Example Networks",
"latitude": 52.3824,
"longitude": 4.8995,
"auth_failure": "dmarc",
"authentication_results": "mx.example.net; dmarc=fail (p=none) header.from=acme.com; spf=softfail smtp.mailfrom=acme.com; dkim=none",
"original_mail_from": "billing@acme.com",
"original_rcpt_to": "ada@example.net",
"subject": "Your invoice is ready",
"delivery_result": "delivered",
"reported_domain": "acme.com",
"created_at": "2026-09-28 18:02:16.448210+00"
}
],
"meta": { "total": 1, "limit": 25, "offset": 0 }
}{
"error": "Domain not found"
}Načtení forenzního reportu
Načte jeden forenzní (RUF) report s hlavičkami zprávy, která neprošla kontrolou DMARC. Vyžaduje API klíč s oprávněním full. Forenzní reporty mohou obsahovat osobní údaje, například adresy příjemců a předměty.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/forensic/{report_id}Parametry v cestě
idstringpovinnédom_…), nebo název domény.report_idstringpovinnédmr_…).Odpověď
Vrací forenzní report s poli popsanými na stránce Výpis forenzních reportů a navíc:
headersstring | nullPokud doména neexistuje, report neexistuje nebo nejde o zpracovaný forenzní report, vrací 404.
{
"object": "dmarc_forensic_report",
"id": "dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk",
"report_id": "dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk",
"arrival_date": "2026-09-28 17:44:02+00",
"source_ip": "203.0.113.77",
"country_code": "NL",
"country_name": "Netherlands",
"continent_code": "EU",
"asn": 64511,
"as_org": "Example Networks",
"latitude": 52.3824,
"longitude": 4.8995,
"auth_failure": "dmarc",
"authentication_results": "mx.example.net; dmarc=fail (p=none) header.from=acme.com; spf=softfail smtp.mailfrom=acme.com; dkim=none",
"original_mail_from": "billing@acme.com",
"original_rcpt_to": "ada@example.net",
"subject": "Your invoice is ready",
"delivery_result": "delivered",
"reported_domain": "acme.com",
"headers": "From: Acme Billing <billing@acme.com>\r\nTo: ada@example.net\r\nSubject: Your invoice is ready\r\nDate: Mon, 28 Sep 2026 17:43:58 +0000\r\nMessage-ID: <20260928174358.4f1c@mail.acme.com>",
"created_at": "2026-09-28 18:02:16.448210+00"
}{
"error": "Forensic report not found"
}Načtení statistik
Shrnuje souhrnné DMARC reporty domény za zvolené období: kolik pošty z vaší domény přijímající servery viděly, kolik jí prošlo a odkud pocházela. Z těchto dat vychází karta Overview v sekci Email APIDMARC reports. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty (dmarc_reports: true v endpointu Úprava domény), což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/statsParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstring2026-09-01. Bez tohoto parametru se započítají všechny reporty.tostringOdpověď
Vrací data s těmito poli. Zpráva se počítá jako úspěšná, když má výsledek DKIM nebo SPF se zarovnáním podle DMARC hodnotu pass.
total_volumeintegerpass_volume, fail_volumeintegerpass_ratenumber0, když není žádný objem.report_countintegerdispositionsobject[]disposition (none, quarantine, reject) a volume.dkim, spfobject[]result (pass, nebo fail) a volume.dailyobject[]date ve tvaru YYYY-MM-DD, UTC) s volume, pass_volume a fail_volume.daily_dispositions, daily_dkim, daily_spfobject[]date, disposition nebo result a volume.top_countriesobject[]country_code, country_name, volume, pass_volume, fail_volume.top_asnsobject[]asn, as_org, volume, pass_volume, fail_volume.unknown_geo_volumeintegerPokud doména ve workspace neexistuje, vrací 404.
{
"data": {
"total_volume": 3712,
"pass_volume": 3688,
"fail_volume": 24,
"pass_rate": 99.35,
"report_count": 6,
"dispositions": [
{ "disposition": "none", "volume": 3712 }
],
"dkim": [
{ "result": "pass", "volume": 3680 },
{ "result": "fail", "volume": 32 }
],
"spf": [
{ "result": "pass", "volume": 3676 },
{ "result": "fail", "volume": 36 }
],
"daily": [
{ "date": "2026-09-28", "volume": 1860, "pass_volume": 1848, "fail_volume": 12 },
{ "date": "2026-09-29", "volume": 1852, "pass_volume": 1840, "fail_volume": 12 }
],
"daily_dispositions": [
{ "date": "2026-09-28", "disposition": "none", "volume": 1860 },
{ "date": "2026-09-29", "disposition": "none", "volume": 1852 }
],
"daily_dkim": [
{ "date": "2026-09-28", "result": "pass", "volume": 1844 },
{ "date": "2026-09-28", "result": "fail", "volume": 16 },
{ "date": "2026-09-29", "result": "pass", "volume": 1836 },
{ "date": "2026-09-29", "result": "fail", "volume": 16 }
],
"daily_spf": [
{ "date": "2026-09-28", "result": "pass", "volume": 1842 },
{ "date": "2026-09-28", "result": "fail", "volume": 18 },
{ "date": "2026-09-29", "result": "pass", "volume": 1834 },
{ "date": "2026-09-29", "result": "fail", "volume": 18 }
],
"top_countries": [
{ "country_code": "US", "country_name": "United States", "volume": 3688, "pass_volume": 3688, "fail_volume": 0 },
{ "country_code": "NL", "country_name": "Netherlands", "volume": 24, "pass_volume": 0, "fail_volume": 24 }
],
"top_asns": [
{ "asn": 64500, "as_org": "Example Hosting", "volume": 3688, "pass_volume": 3688, "fail_volume": 0 },
{ "asn": 64511, "as_org": "Example Networks", "volume": 24, "pass_volume": 0, "fail_volume": 24 }
],
"unknown_geo_volume": 0
}
}{
"error": "Domain not found"
}Výpis odesílacích zdrojů
Seskupí souhrnná data DMARC domény podle zdrojové IP adresy, od největšího objemu. Pomůže vám najít servery, které odesílají jménem vaší domény, ale neprocházejí kontrolou SPF a DKIM. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/sourcesParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstringtostringlimitintegervýchozí: 50offsetintegervýchozí: 0Odpověď
Vrací data a meta (limit, offset). Odpověď neobsahuje celkový počet; načítejte další stránky, dokud data nemá méně položek než limit. Každý zdroj obsahuje:
source_ipstringcountry_code, country_namestring | nullasn, as_orginteger | string | nullvolumeintegerpass_volume, fail_volumeintegerPokud doména ve workspace neexistuje, vrací 404.
{
"data": [
{
"source_ip": "198.51.100.24",
"country_code": "US",
"country_name": "United States",
"asn": 64500,
"as_org": "Example Hosting",
"volume": 3688,
"pass_volume": 3688,
"fail_volume": 0
},
{
"source_ip": "203.0.113.77",
"country_code": "NL",
"country_name": "Netherlands",
"asn": 64511,
"as_org": "Example Networks",
"volume": 24,
"pass_volume": 0,
"fail_volume": 24
}
],
"meta": { "limit": 50, "offset": 0 }
}{
"error": "Domain not found"
}Výpis zemí
Seskupí souhrnná data DMARC domény podle země odesílající IP adresy, od největšího objemu. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/countriesParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstringtostringlimitintegervýchozí: 50offsetintegervýchozí: 0Odpověď
Vrací data a meta (limit, offset). Každá země obsahuje:
country_codestring | nullnull jsou seskupené IP adresy, které se nepodařilo lokalizovat.country_namestring | nullcontinent_codestring | nullEU.volumeintegerpass_volume, fail_volumeintegerPokud doména ve workspace neexistuje, vrací 404.
{
"data": [
{
"country_code": "US",
"country_name": "United States",
"continent_code": "NA",
"volume": 3688,
"pass_volume": 3688,
"fail_volume": 0
},
{
"country_code": "NL",
"country_name": "Netherlands",
"continent_code": "EU",
"volume": 24,
"pass_volume": 0,
"fail_volume": 24
}
],
"meta": { "limit": 50, "offset": 0 }
}{
"error": "Domain not found"
}Výpis sítí (ASN)
Seskupí souhrnná data DMARC domény podle autonomního systému (ASN) odesílající IP adresy, od největšího objemu. Síť obvykle odpovídá poskytovateli hostingu nebo e-mailové službě, takže legitimní odesílatele snáz poznáte. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/asnsParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstringtostringlimitintegervýchozí: 50offsetintegervýchozí: 0Odpověď
Vrací data a meta (limit, offset). Každá síť obsahuje:
asninteger | nullnull jsou seskupené IP adresy, které se nepodařilo dohledat.as_orgstring | nullvolumeintegerpass_volume, fail_volumeintegerPokud doména ve workspace neexistuje, vrací 404.
{
"data": [
{
"asn": 64500,
"as_org": "Example Hosting",
"volume": 3688,
"pass_volume": 3688,
"fail_volume": 0
},
{
"asn": 64511,
"as_org": "Example Networks",
"volume": 24,
"pass_volume": 0,
"fail_volume": 24
}
],
"meta": { "limit": 50, "offset": 0 }
}{
"error": "Domain not found"
}Výpis odesílatelů reportů
Vypíše organizace, které pro doménu poslaly zpracované souhrnné reporty, od těch s nejvíce reporty. Vyžaduje API klíč s oprávněním full.
Reporty přicházejí jen u domén se zapnutými DMARC reporty, což vyžaduje tarif Pro nebo vyšší.
/domains/{id}/dmarc/reportersParametry v cestě
idstringpovinnédom_…), nebo název domény.Parametry dotazu
fromstringtostringlimitintegervýchozí: 50offsetintegervýchozí: 0Odpověď
Vrací data a meta (limit, offset). Každý odesílatel reportů obsahuje:
org_namestring | nullgoogle.com. Pokud chcete vidět její reporty, předejte ho jako org_name endpointu Výpis souhrnných reportů.org_emailstring | nullreport_countintegerPokud doména ve workspace neexistuje, vrací 404.
{
"data": [
{ "org_name": "google.com", "org_email": "noreply-dmarc-support@google.com", "report_count": 30 },
{ "org_name": "Enterprise Outlook", "org_email": "dmarcreport@microsoft.com", "report_count": 28 },
{ "org_name": "Yahoo", "org_email": "dmarchelp@yahooinc.com", "report_count": 14 }
],
"meta": { "limit": 50, "offset": 0 }
}{
"error": "Domain not found"
}