Overview
The Domain Security endpoint returns DKIM, DMARC, and SPF scores for your monitored domains, along with email pass/fail statistics. Use it to track email security compliance across all client domains.
Base URL: https://portal.lupasafe.com
Authentication: X-Api-Key: ls_your_api_key_here
Endpoint
| Endpoint | Description |
|---|---|
GET /reporting/v1/domains | DKIM, DMARC, and SPF scores per domain, email pass/fail statistics, last scan date |
Parameters
- limit — default 50, max 500
- offset — for pagination
Response Fields
| Field | Description |
|---|---|
domain_name | The domain |
dkim_score | DKIM score (0–100) |
dmarc_score | DMARC score (0–100) |
spf_score | SPF score (0–100) |
total_emails | Number of emails analysed |
both_pass_count | Emails where both SPF and DKIM passed |
both_fail_count | Emails where both SPF and DKIM failed |
last_updated | Timestamp of the last scan |
Example Request
GET /reporting/v1/domains?limit=10
X-Api-Key: ls_your_api_key_hereNotes
- Scores are on a scale of 0–100. Higher scores indicate better configuration.
- Use
both_pass_countandboth_fail_countto identify domains with active email authentication issues. - The
last_updatedfield shows when Lupasafe last scanned the domain — useful for verifying data freshness. - MSP keys return data across all client domains; client keys return only the client's own domains.