InfraGuard

InfraGuard is deliverability monitoring for your sending domains: blacklist checks, DNS/DMARC watchdog, and bounce-rate tracking, with alerts and actionable “action items” when something needs attention.

Method	Path	Description
`POST`	`/v1/api/infra-guard/list`	List InfraGuard subscriptions
`GET`	`/v1/api/infra-guard/details`	Get one subscription’s details
`POST`	`/v1/api/infra-guard/enable`	Enable InfraGuard for domain(s)
`POST`	`/v1/api/infra-guard/cancel`	Cancel InfraGuard for domain(s)
`GET`	`/v1/api/infra-guard/pricing`	Get current pricing
`GET`	`/v1/api/infra-guard/stats`	Get aggregate statistics
`GET`	`/v1/api/infra-guard/blacklist-history`	Blacklist check history
`GET`	`/v1/api/infra-guard/dns-history`	DNS watchdog check history
`GET`	`/v1/api/infra-guard/bounce-metrics`	Current bounce metrics
`GET`	`/v1/api/infra-guard/bounce-history`	Bounce check history
`POST`	`/v1/api/infra-guard/update-settings`	Update subscription settings
`POST`	`/v1/api/infra-guard/trigger-check`	Trigger a manual check immediately
`POST`	`/v1/api/infra-guard/alerts`	List alerts
`POST`	`/v1/api/infra-guard/acknowledge-alert`	Acknowledge an alert
`POST`	`/v1/api/infra-guard/resolve-alert`	Resolve an alert
`POST`	`/v1/api/infra-guard/action-items`	List action items
`GET`	`/v1/api/infra-guard/action-items/stats`	Action item statistics
`POST`	`/v1/api/infra-guard/resolve-action-item`	Resolve an action item
`POST`	`/v1/api/infra-guard/dismiss-action-item`	Dismiss an action item

Enable monitoring


curl -X POST https://api.infrabox.software/v1/api/infra-guard/enable \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{ "domain_uids": ["<domain_uid>"] }'

Poll for alerts


curl -X POST https://api.infrabox.software/v1/api/infra-guard/alerts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{ "status": "open" }'

Acknowledge with /acknowledge-alert, and resolve once handled with /resolve-alert. Prefer webhooks over polling /alerts if you’re monitoring more than a handful of domains.

InfraGuard is billed separately per monitored domain — check /v1/api/infra-guard/pricing before enabling it in bulk.

Errors

Status	Meaning
`400`	Invalid body
`401`	Missing/invalid API key
`404`	Domain, subscription, alert, or action item not found
`500`	Internal error