Bulk mail configuration check API

Bulk price

$0.024 per item, minimum $0.03 per request, at most 20 items. The price is for the whole batch and is known before you pay.

Input

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

Example request

curl -i -X POST https://api.probekit.dev/v1/mail/check/bulk \
  -H 'content-type: application/json' \
  -d '{"domains": ["example.com", "example.org"]}'

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.probekit.dev/v1/mail/check/bulk', json={'domains': ['example.com', 'example.org']})
        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.probekit.dev/v1/mail/check/bulk", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"domains": ["example.com", "example.org"]}),
});
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",
  "endpoint": "mail.check.bulk",
  "failed_count": 0,
  "item_count": 2,
  "request_id": "req_aaaaaaaaaaaaaaaaaaaaaaaaaa",
  "results": [
    {
      "error": null,
      "index": 0,
      "item": "example.com",
      "result": {
        "checked_at": "2026-10-24T12:00:00Z",
        "data": {
          "dkim": [],
          "dmarc": {
            "adkim": "r",
            "applied_policy": "reject",
            "aspf": "r",
            "domain": "example.com",
            "org_domain": "example.com",
            "pct": 100,
            "policy": "reject",
            "record": "v=DMARC1; p=reject; rua=mailto:[email protected]",
            "record_domain": "example.com",
            "rua": [
              "mailto:[email protected]"
            ],
            "ruf": [],
            "subdomain_policy": "reject",
            "tags": [
              {
                "name": "v",
                "value": "DMARC1"
              },
              {
                "name": "p",
                "value": "reject"
              },
              {
                "name": "rua",
                "value": "mailto:[email protected]"
              }
            ]
          },
          "domain": "example.com",
          "mx": {
            "domain": "example.com",
            "hosts": [
              {
                "addresses": [
                  "192.0.2.25"
                ],
                "exchange": "mx1.example.com",
                "preference": 10,
                "resolved": true
              },
              {
                "addresses": [
                  "192.0.2.26"
                ],
                "exchange": "mx2.example.com",
                "preference": 20,
                "resolved": true
              }
            ],
            "implicit_mx": false,
            "null_mx": false
          },
          "spf": {
            "all_qualifier": "-",
            "dns_lookup_count": 1,
            "domain": "example.com",
            "lookup_count_complete": true,
            "record": "v=spf1 ip4:192.0.2.0/24 include:_spf.example.net -all",
            "tree": {
              "children": [
                {
                  "children": [],
                  "domain": "_spf.example.net",
                  "error": null,
                  "record": "v=spf1 ip4:198.51.100.0/24 -all",
                  "terms": [
                    {
                      "kind": "mechanism",
                      "name": "ip4",
                      "qualifier": null,
                      "raw": "ip4:198.51.100.0/24",
                      "value": "198.51.100.0/24"
                    },
                    {
                      "kind": "mechanism",
                      "name": "all",
                      "qualifier": "-",
                      "raw": "-all",
                      "value": null
                    }
                  ],
                  "via": "include"
                }
              ],
              "domain": "example.com",
              "error": null,
              "record": "v=spf1 ip4:192.0.2.0/24 include:_spf.example.net -all",
              "terms": [
                {
                  "kind": "mechanism",
                  "name": "ip4",
                  "qualifier": null,
                  "raw": "ip4:192.0.2.0/24",
                  "value": "192.0.2.0/24"
                },
                {
                  "kind": "mechanism",
                  "name": "include",
                  "qualifier": null,
                  "raw": "include:_spf.example.net",
                  "value": "_spf.example.net"
                },
                {
                  "kind": "mechanism",
                  "name": "all",
                  "qualifier": "-",
                  "raw": "-all",
                  "value": null
                }
              ],
              "via": "root"
            },
            "void_lookup_count": 0
          }
        },
        "endpoint": "mail.check",
        "findings": [],
        "meta": {
          "cache_hit": false,
          "duration_ms": 42,
          "fresh_until": "2026-10-24T12:05:00Z",
          "observed_at": "2026-10-24T12:00:00Z",
          "resolver": "example",
          "source": "dns"
        },
        "request_id": "req_aaaaaaaaaaaaaaaaaaaaaaaaaa",
        "schema_version": "1.0",
        "status": "ok"
      }
    },
    {
      "error": null,
      "index": 1,
      "item": "example.org",
      "result": {
        "checked_at": "2026-10-24T12:00:00Z",
        "data": {
          "dkim": [],
          "dmarc": {
            "adkim": null,
            "applied_policy": null,
            "aspf": null,
            "domain": "example.org",
            "org_domain": "example.org",
            "pct": null,
            "policy": null,
            "record": null,
            "record_domain": null,
            "rua": [],
            "ruf": [],
            "subdomain_policy": null,
            "tags": []
          },
          "domain": "example.org",
          "mx": {
            "domain": "example.org",
            "hosts": [],
            "implicit_mx": false,
            "null_mx": false
          },
          "spf": {
            "all_qualifier": null,
            "dns_lookup_count": 0,
            "domain": "example.org",
            "lookup_count_complete": true,
            "record": null,
            "tree": null,
            "void_lookup_count": 0
          }
        },
        "endpoint": "mail.check",
        "findings": [
          {
            "code": "DMARC_NOT_FOUND",
            "evidence": {
              "count": 1,
              "items": [
                {
                  "domain": "example.org",
                  "org_domain": "example.org"
                }
              ]
            },
            "explanation": "Without DMARC, receivers apply their own handling to mail that fails SPF and DKIM alignment, and the domain owner receives no reports.",
            "message": "No DMARC record was found for the domain or its organisational domain.",
            "recommendation": "Publish a DMARC record, for example with p=none and a rua address, and use the reports to plan further steps.",
            "severity": "warning"
          },
          {
            "code": "DNS_DOMAIN_NOT_FOUND",
            "evidence": {
              "count": 2,
              "items": [
                {
                  "name": "example.org"
                },
                {
                  "name": "example.org"
                }
              ]
            },
            "explanation": "The resolver answered NXDOMAIN: it found no records for this name. Another resolver or a recent registration or delegation change could give a different answer.",
            "message": "The DNS resolver reported that the domain does not exist.",
            "recommendation": "Check the spelling and that the domain is registered and delegated.",
            "severity": "error"
          }
        ],
        "meta": {
          "cache_hit": false,
          "duration_ms": 42,
          "fresh_until": "2026-10-24T12:05:00Z",
          "observed_at": "2026-10-24T12:00:00Z",
          "resolver": "example",
          "source": "dns"
        },
        "request_id": "req_aaaaaaaaaaaaaaaaaaaaaaaaaa",
        "schema_version": "1.0",
        "status": "error"
      }
    }
  ],
  "retry_token": null,
  "schema_version": "1.0",
  "succeeded_count": 2
}

Response fields

Fields in results[].result.data

Items that failed for a technical reason can be run again free of charge with the free retry.

Status codes

Errors use the common error body. See errors.

Findings this endpoint can return