Email authentication
GET
/api/v1/dmarc-checkerPacketFlo DMARC Checker API
Cost: 1 credit per request
See a domain's DMARC policy and where failure reports go.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain to check. |
Example request
curl "https://packetflo.io/api/v1/dmarc-checker?domain=example.com&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "domain": "example.com", "found": true, "record": "v=DMARC1; p=reject; pct=100; rua=mailto:[email protected]", "recordDomain": "example.com", "inherited": false, "effectivePolicy": "reject", "tags": { "v": "DMARC1", "p": "reject", "pct": "100", "rua": "mailto:[email protected]" } }, "meta": { "tool": "dmarc-checker", "version": "v1" } }
Reading the result
Finds a direct DMARC policy or an applicable parent-domain policy and reports the effective p or sp value.
Response fields
| Field | What it tells you |
|---|---|
found / record | Whether a DMARC record was found and its text. |
recordDomain / inherited / effectivePolicy | Where the policy was published, whether it is inherited and the policy that applies to the entered domain. |
tags | Published tags such as p, sp and rua. |
Scope and limits
Walks the DNS policy tree with a bounded number of queries. It does not validate live email alignment or confirm that every receiving server enforces the policy.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 1 credit from the key's shared 300-credit rolling 24-hour budget. Credits are charged before parameter validation. Successful responses and quota errors include usage headers; GET and OPTIONS support CORS.
| API status | Meaning |
|---|---|
200 | The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition. |
400 | Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details. |
401 | Missing, invalid or revoked API key. |
429 | The request would exceed the key's available credit budget. |