Přejít na obsah
Dokumentace

Čtěte souhrnné a forenzní DMARC reporty odesílací domény, nebo nahrajte vlastní.

Základní URLhttps://api.emailit.com/v2AutentizaceChybyLimity rychlosti

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ů.

GET/domains/{id}/dmarc/reports

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény, například acme.com.

Parametry dotazu

typestring
aggregate, nebo forensic.
statusstring
Stav zpracování: pending, processed, failed nebo duplicate.
org_namestring
Přesný název organizace, která report poslala, například google.com.
fromstring
Jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či později, například 2026-09-01.
tostring
Jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 25
Počet reportů na stránce, nejvýše 100.
offsetintegervýchozí: 0
Počet reportů, které se mají přeskočit.
matchstring

Hodnota all (výchozí) vyžaduje shodu se všemi filtry. S hodnotou or stačí shoda s kterýmkoli filtrem. Viz Filtrování.

orderstring

Klíč řazení pro tento výpis. Viz klíče řazení níže.

directionstring

asc, 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.

idstring
ID reportu s předponou dmr_.
typestring | null
aggregate, nebo forensic. U nahraného reportu null, dokud se nezpracuje.
sourcestring
smtp u reportů, které Emailit přijal na adresu domény pro reporty, upload u reportů, které jste nahráli.
statusstring
pending, processed, failed (viz error_message) nebo duplicate (stejný report už byl zpracován).
org_name, org_emailstring | null
Organizace, která report poslala, a její kontaktní adresa.
external_report_idstring | null
Vlastní ID reportu, které mu přidělil jeho odesílatel.
date_range_begin, date_range_endstring | null
Období, které report pokrývá, v UTC.
policy_domain, adkim, aspf, p, sp, pct, fostring | integer | null
Politika DMARC, kterou odesílatel reportu u vaší domény našel: režimy zarovnání (r, nebo s), politika a politika pro subdomény (none, quarantine, reject), procento a volby pro hlášení selhání.
original_filenamestring | null
Název souboru nahraného reportu.
envelope_tostring | null
Adresa pro reporty, na kterou byl report odeslán.
created_at, updated_at, processed_atstring | null
Časová razítka v UTC.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/reports
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/reports \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d type=aggregate \
  -d from=2026-09-01 \
  -d limit=50
JSON
{
  "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 }
}

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šší.

GET/domains/{id}/dmarc/reports/{report_id}

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.
report_idstringpovinné
ID reportu (dmr_…).

Parametry dotazu

limitintegervýchozí: 100
Počet záznamů, které se mají vrátit, nejvýše 500. Jen u souhrnných reportů.
offsetintegervýchozí: 0
Počet záznamů, které se mají přeskočit. Jen u souhrnných reportů.

Odpověď

Vrací objekt reportu (viz Výpis souhrnných reportů) a navíc:

recordsobject[]
Jen u souhrnných reportů. Jedna položka pro každou kombinaci zdrojové IP adresy a výsledku. Pole jsou popsaná níže.
metaobject
Jen u souhrnných reportů. Celkový počet záznamů total, limit a offset.
forensicobject | null
Jen u forenzních reportů. Stejná pole jako u endpointu Načtení forenzního reportu.

Každý záznam obsahuje:

source_ipstring
IP adresa, ze které byly zprávy odeslány.
countinteger
Počet zpráv z tohoto zdroje s těmito výsledky.
country_code, country_name, continent_code, asn, as_org, latitude, longitudestring | integer | number | null
Poloha a síť zdrojové IP adresy. null, když se IP adresu nepodařilo lokalizovat.
dispositionstring
Co přijímající server se zprávami udělal: none, quarantine nebo reject.
dkim, spfstring
Výsledky se zarovnáním podle DMARC, jak je vyhodnotil přijímající server: pass, nebo fail.
header_from, envelope_from, envelope_tostring | null
Identifikátory z reportu.
dkim_domain, dkim_selector, dkim_resultstring | null
Podpis DKIM, který přijímající server kontroloval, a jeho surový výsledek.
spf_domain, spf_resultstring | null
Doména SPF, kterou přijímající server kontroloval, a její surový výsledek.
reason_type, reason_commentstring | null
Důvod přepsání politiky, například forwarded nebo mailing_list.

Pokud doména nebo report neexistuje, vrací 404.

GET/domains/{id}/dmarc/reports/{report_id}
Terminal
curl https://api.emailit.com/v2/domains/acme.com/dmarc/reports/dmr_3Xu63kEs8KCiyOZ1TDgnttppitx \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "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 }
}

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ě.

POST/domains/{id}/dmarc/reports

Parametry v cestě

idstringpovinné
ID domény (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
Soubor zakódovaný v Base64. Použijte ho pro binární formáty: souhrnné reporty jako .xml, .xml.gz nebo .zip a forenzní reporty jako .eml (AFRF).
contentstring
Report jako text v UTF-8, například surové XML souhrnného reportu.
filenamestring
Původní název souboru, uloží se jako original_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.
POST/domains/{id}/dmarc/reports
Terminal
curl -X POST https://api.emailit.com/v2/domains/acme.com/dmarc/reports \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"filename\": \"google-acme.com-2026-09-29.xml.gz\",
    \"content_base64\": \"$(base64 < 'google-acme.com-2026-09-29.xml.gz' | tr -d '\n')\"
  }"
JSON
{
  "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
}

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.

GET/domains/{id}/dmarc/forensic

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či později.
tostring
Jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 25
Počet reportů na stránce, nejvýše 100.
offsetintegervýchozí: 0
Počet reportů, které se mají přeskočit.

Obecné 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:

objectstring
dmarc_forensic_report.
id, report_idstring
ID reportu (dmr_…).
arrival_datestring | null
Kdy neúspěšná zpráva dorazila na přijímající server.
source_ipstring | null
IP adresa, ze které byla zpráva odeslána.
country_code, country_name, continent_code, asn, as_org, latitude, longitudestring | integer | number | null
Poloha a síť zdrojové IP adresy.
auth_failurestring | null
Co selhalo, například dmarc, spf nebo dkim.
authentication_resultsstring | null
Hlavička Authentication-Results od přijímajícího serveru.
original_mail_from, original_rcpt_to, subjectstring | null
Odesílatel v obálce, příjemce a předmět neúspěšné zprávy.
delivery_resultstring | null
Co přijímající server se zprávou udělal, například reject nebo delivered.
reported_domainstring | null
Vaše doména, jak je uvedená v reportu.
created_atstring | null
Kdy Emailit report uložil.
GET/domains/{id}/dmarc/forensic
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/forensic \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d from=2026-09-01
JSON
{
  "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 }
}

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šší.

GET/domains/{id}/dmarc/forensic/{report_id}

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.
report_idstringpovinné
ID forenzního reportu (dmr_…).

Odpověď

Vrací forenzní report s poli popsanými na stránce Výpis forenzních reportů a navíc:

headersstring | null
Původní hlavičky zprávy obsažené v reportu, jako surový text.

Pokud doména neexistuje, report neexistuje nebo nejde o zpracovaný forenzní report, vrací 404.

GET/domains/{id}/dmarc/forensic/{report_id}
Terminal
curl https://api.emailit.com/v2/domains/acme.com/dmarc/forensic/dmr_3MjUXgcEBO0o7FkzeBdlrCY6NYk \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "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"
}

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šší.

GET/domains/{id}/dmarc/stats

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či později, například 2026-09-01. Bez tohoto parametru se započítají všechny reporty.
tostring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).

Odpověď

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_volumeinteger
Počet nahlášených zpráv.
pass_volume, fail_volumeinteger
Zprávy, které prošly a neprošly.
pass_ratenumber
Procento zpráv, které prošly, zaokrouhlené na dvě desetinná místa. 0, když není žádný objem.
report_countinteger
Zpracované reporty v daném období, souhrnné i forenzní.
dispositionsobject[]
Objem podle akce přijímajícího serveru: disposition (none, quarantine, reject) a volume.
dkim, spfobject[]
Objem podle výsledku se zarovnáním: result (pass, nebo fail) a volume.
dailyobject[]
Jedna položka za každý den (date ve tvaru YYYY-MM-DD, UTC) s volume, pass_volume a fail_volume.
daily_dispositions, daily_dkim, daily_spfobject[]
Stejné rozpady po dnech: date, disposition nebo result a volume.
top_countriesobject[]
Nejvýše 10 zemí podle objemu: country_code, country_name, volume, pass_volume, fail_volume.
top_asnsobject[]
Nejvýše 10 sítí podle objemu: asn, as_org, volume, pass_volume, fail_volume.
unknown_geo_volumeinteger
Zprávy z IP adres, které se nepodařilo lokalizovat.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/stats
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/stats \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d from=2026-09-28 \
  -d to=2026-09-29
JSON
{
  "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
  }
}

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šší.

GET/domains/{id}/dmarc/sources

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či později.
tostring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 50
Počet zdrojů na stránce, nejvýše 200.
offsetintegervýchozí: 0
Počet zdrojů, které se mají přeskočit.

Odpověď

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_ipstring
Odesílající IP adresa.
country_code, country_namestring | null
Kde se IP adresa nachází.
asn, as_orginteger | string | null
Síť, do které IP adresa patří.
volumeinteger
Počet zpráv nahlášených z této IP adresy.
pass_volume, fail_volumeinteger
Zprávy, které prošly kontrolou DKIM nebo SPF se zarovnáním podle DMARC, a zprávy, které neprošly ani jednou.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/sources
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/sources \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d from=2026-09-01
JSON
{
  "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 }
}

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šší.

GET/domains/{id}/dmarc/countries

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či později.
tostring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 50
Počet zemí na stránce, nejvýše 200.
offsetintegervýchozí: 0
Počet zemí, které se mají přeskočit.

Odpověď

Vrací data a meta (limit, offset). Každá země obsahuje:

country_codestring | null
Kód podle ISO 3166-1 alpha-2. Pod null jsou seskupené IP adresy, které se nepodařilo lokalizovat.
country_namestring | null
Název země.
continent_codestring | null
Kód kontinentu, například EU.
volumeinteger
Počet zpráv nahlášených z této země.
pass_volume, fail_volumeinteger
Zprávy, které prošly kontrolou DKIM nebo SPF se zarovnáním podle DMARC, a zprávy, které neprošly ani jednou.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/countries
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/countries \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d from=2026-09-01
JSON
{
  "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 }
}

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šší.

GET/domains/{id}/dmarc/asns

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či později.
tostring
Započítá jen období reportů, která začínají zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 50
Počet sítí na stránce, nejvýše 200.
offsetintegervýchozí: 0
Počet sítí, které se mají přeskočit.

Odpověď

Vrací data a meta (limit, offset). Každá síť obsahuje:

asninteger | null
Číslo autonomního systému. Pod null jsou seskupené IP adresy, které se nepodařilo dohledat.
as_orgstring | null
Název organizace, která síť provozuje.
volumeinteger
Počet zpráv nahlášených z této sítě.
pass_volume, fail_volumeinteger
Zprávy, které prošly kontrolou DKIM nebo SPF se zarovnáním podle DMARC, a zprávy, které neprošly ani jednou.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/asns
Terminal
curl -G https://api.emailit.com/v2/domains/acme.com/dmarc/asns \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d from=2026-09-01
JSON
{
  "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 }
}

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šší.

GET/domains/{id}/dmarc/reporters

Parametry v cestě

idstringpovinné
ID domény (dom_…), nebo název domény.

Parametry dotazu

fromstring
Započítá jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či později.
tostring
Započítá jen reporty, jejichž období začíná zadaným datem (nebo datem a časem) či dříve. Datum bez času zahrnuje celý den (UTC).
limitintegervýchozí: 50
Počet odesílatelů reportů na stránce, nejvýše 200.
offsetintegervýchozí: 0
Počet odesílatelů reportů, které se mají přeskočit.

Odpověď

Vrací data a meta (limit, offset). Každý odesílatel reportů obsahuje:

org_namestring | null
Název organizace, která reporty posílá, například google.com. Pokud chcete vidět její reporty, předejte ho jako org_name endpointu Výpis souhrnných reportů.
org_emailstring | null
Kontaktní adresa odesílatele reportů.
report_countinteger
Počet zpracovaných souhrnných reportů od této organizace.

Pokud doména ve workspace neexistuje, vrací 404.

GET/domains/{id}/dmarc/reporters
Terminal
curl https://api.emailit.com/v2/domains/acme.com/dmarc/reporters \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "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 }
}

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.