La API de entregabilidad de email.

curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# devuelve el id del test y la dirección a la que enviar
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# envía tu correo a esa dirección y luego lee el resultado
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# respuesta (200)
{
  "status": "completed",
  "score": 84,
  "results": [
    { "id": "spf", ... },
    { "id": "dkim", ... }
  ]
}

curl -X POST https://api.unspam.email/ext/v2/inbox-placement \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# devuelve el id del test y los buzones semilla a los que enviar
{
  "id": "7Hq2xLpV0aKd",
  "mailboxes": [
    { "id": 12, "name": "Gmail", "address": ... },
    { "id": 31, "name": "Outlook", "address": ... }
  ]
}

# envía a cada dirección con el id de la prueba en el asunto o el cuerpo y luego lee el resultado
curl https://api.unspam.email/ext/v2/inbox-placement/7Hq2xLpV0aKd \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

curl -X POST https://api.unspam.email/ext/v2/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email_source": "raw-data",
    "subject": "Your order shipped",
    "body": "<html>...</html>",
    "devices": ["iphone_15_pro_dm"]
  }'

# consulta el id hasta que status sea completed
{
  "id": "3f9a2c8e-1d4b-4c7a-9f2e-7b1e5da0c62f",
  "status": "pending",
  "previews": [
    { "device_key": "iphone_15_pro_dm", "status": "pending", ... }
  ]
}

curl -X POST https://api.unspam.email/ext/v2/email-verification/instant-checks \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "email": "jane@acme.com" }'

# consulta el id hasta que la comprobación termine
{
  "email": "jane@acme.com",
  "status": "completed",
  "result": {
    "status": "deliverable",
    "reason": "accepted",
    "action": "keep"
  }
}

curl -X POST https://api.unspam.email/ext/v2/dmarc/domains \
  -H "Authorization: Bearer $UNSPAM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "yourdomain.com" }'

# publica este registro TXT y luego llama a verify
{
  "domain": { "status": "pending_dns", ... },
  "dns_instructions": {
    "host": "_dmarc.yourdomain.com",
    "type": "TXT",
    "value": "v=DMARC1; p=none; rua=mailto:reports+a1b2c3d4@dmarc.unspam.email"
  }
}

curl -X POST https://api.unspam.email/ext/v2/scheduled-tests \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# envía tu correo a inbox_address y luego define la programación
{
  "id": "9c41e7a2-52bd-4f0e-a6c3-1d8e0b7f3a64",
  "status": "draft",
  "inbox_address": "test-xyz@check.unspam.email"
}

# cuando esté en marcha, lee los resultados de cada ejecución
curl https://api.unspam.email/ext/v2/scheduled-tests/9c41e7a2-52bd-4f0e-a6c3-1d8e0b7f3a64/runs \
  -H "Authorization: Bearer $UNSPAM_TOKEN"