API Authentication

API Keys

DMARC.WS provides API access for programmatic domain management and report retrieval.

Creating an API Key

1. Go to Dashboard → API Keys in the sidebar
2. Click Create API Key
3. Give it a descriptive name
4. Copy the key immediately — it won't be shown again

Using Your API Key

Include the key in the X-API-Key header:

curl -H "X-API-Key: dmws_abc123..." https://api.dmarc.ws/v1/orgs/YOUR_ORG_ID/domains

Rate Limits

Plan	Rate Limit
Free	100 requests/hour
Enhanced	1,000 requests/hour
Enterprise	10,000 requests/hour

Base URL

https://api.dmarc.ws/v1

Common Endpoints

Method	Path	Description
GET	/orgs/:orgId/domains	List domains
POST	/orgs/:orgId/domains	Add a domain
GET	/orgs/:orgId/domains/:id/stats	Get domain stats
GET	/orgs/:orgId/domains/:id/reports	List reports
POST	/dmarc/check	Check DMARC record
POST	/spf/check	Check SPF record
POST	/dkim/check	Check DKIM record

All responses follow this format:

{
  "data": { ... },
  "requestId": "abc123"
}

Errors return:

{
  "error": "Description of the error",
  "requestId": "abc123"
}