DMARC record parser API

Input

A JSON body with content-type: application/json.

Example request

curl -i -X POST https://api.lookproof.dev/v1/mail/dmarc-parse \
  -H 'content-type: application/json' \
  -d '{"record": "v=DMARC1; p=quarantine; rua=mailto:[email protected]; adkim=s"}'

import asyncio
import os

from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import register_exact_evm_client


async def main() -> None:
    signer = EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"]))
    client = register_exact_evm_client(x402Client(), signer, networks="eip155:8453")
    async with x402HttpxClient(client) as http:
        response = await http.post('https://api.lookproof.dev/v1/mail/dmarc-parse', json={'record': 'v=DMARC1; p=quarantine; rua=mailto:[email protected]; adkim=s'})
        response.raise_for_status()
        print(response.json())


asyncio.run(main())

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const response = await fetchWithPayment("https://api.lookproof.dev/v1/mail/dmarc-parse", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"record": "v=DMARC1; p=quarantine; rua=mailto:[email protected]; adkim=s"}),
});
console.log(await response.json());

curl: unpaid request — returns 402 with the price (PAYMENT-REQUIRED). The Python and JavaScript clients pay it and send the request again. Only ordinary wallets (EOA) can pay; smart-contract wallets get a 402 without charge. See payments.

Example response

{
  "checked_at": "2026-10-24T12:00:00Z",
  "data": {
    "adkim": "s",
    "aspf": "r",
    "is_dmarc": true,
    "nonexistent_policy": "quarantine",
    "notes": [
      "The policy shown is the record's own p=; for a subdomain the sp= or np= value can apply instead. The DMARC check on a domain decides which record and policy apply.",
      "Whether a report address in another domain accepts reports (RFC 9989 external destination verification) needs DNS and is not checked."
    ],
    "pct": 100,
    "policy": "quarantine",
    "psd": null,
    "record": "v=DMARC1; p=quarantine; rua=mailto:[email protected]; adkim=s",
    "rua": [
      "mailto:[email protected]"
    ],
    "ruf": [],
    "subdomain_policy": "quarantine",
    "tags": [
      {
        "name": "v",
        "value": "DMARC1"
      },
      {
        "name": "p",
        "value": "quarantine"
      },
      {
        "name": "rua",
        "value": "mailto:[email protected]"
      },
      {
        "name": "adkim",
        "value": "s"
      }
    ],
    "test_mode": false,
    "unknown_tags": []
  },
  "endpoint": "mail.dmarc_parse",
  "findings": [],
  "meta": {
    "cache_hit": false,
    "duration_ms": 42,
    "fresh_until": "2026-10-24T12:05:00Z",
    "observed_at": "2026-10-24T12:00:00Z",
    "resolver": null,
    "source": "offline"
  },
  "request_id": "req_aaaaaaaaaaaaaaaaaaaaaaaaaa",
  "schema_version": "1.0",
  "status": "ok"
}

Response fields

Fields in data

Status codes

Errors use the common error body. See errors.

Findings this endpoint can return