An email address in. Structured JSON out.

# Stateless. No address, no DNS, nothing stored.
curl -X POST $MAILMINT_URL/v1/parse \
  -H "Authorization: Bearer $MAILMINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Invoice INV-2291 from Acme Ltd",
  "text": "Invoice INV-2291\n\nTotal: $31.50\nDue: Sep 8, 2026\n",
  "schema": [
    { "name": "invoice_number", "type": "string",
      "description": "the invoice or reference number" },
    { "name": "total", "type": "number",
      "description": "grand total including tax" },
    { "name": "due_date", "type": "date",
      "description": "when payment is due" }
  ]
}'

import { readFile } from 'node:fs/promises';

const raw = await readFile('message.eml');
const res = await fetch(`${process.env.MAILMINT_URL}/v1/parse`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MAILMINT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    raw_mime: raw.toString('base64'),
    schema: [
      { name: 'invoice_number', type: 'string' },
      { name: 'total',          type: 'number' },
    ],
  }),
});
const result = await res.json();
if (result.needs_review) console.warn('check this one:', result.flags);
console.log(result.fields.total.value, result.fields.total.confidence);

import base64, os, pathlib, requests

raw = pathlib.Path("message.eml").read_bytes()
res = requests.post(
    f"{os.environ['MAILMINT_URL']}/v1/parse",
    headers={"Authorization": f"Bearer {os.environ['MAILMINT_API_KEY']}"},
    json={
        "raw_mime": base64.b64encode(raw).decode(),
        "schema": [
            {"name": "invoice_number", "type": "string"},
            {"name": "total", "type": "number"},
        ],
    },
    timeout=60,
)
res.raise_for_status()
result = res.json()
if result["needs_review"]:
    print("check this one:", result["flags"])
total = result["fields"]["total"]
print(total["value"], total["confidence"], total["evidence"])

# Mail sent to your address is POSTed to your webhook_url.
POST /your/endpoint HTTP/1.1
content-type: application/json
x-mailmint-event: message.parsed
x-mailmint-delivery: dlv_01JQ8Z3K4M5N6P7Q8R9S
x-mailmint-signature: t=1787648043,v1=6a1f…c07b

{
  "id": "msg_01JQ8Z3K4M5N6P7Q8R9S",
  "mailbox": { "address": "k7m2xq4h9bwz@smooth-operator.online", … },
  "envelope": { "from": "billing@acme.example", "tls": true, … },
  "auth": { "spf": "pass", "dkim": "pass", "dmarc": "pass" },
  "fields": { /* value, confidence, source, evidence */ },
  "flags": [], "needs_review": false, "status": "parsed"
}

# v1 = hex hmac_sha256(secret, t + "." + rawBody)
# Retries at 0s, 30s, 2m, 10m, 1h, 6h. 10s timeout each.