Abuse Signals API — Documentation

Deterministic, signals-only abuse indicators. No advice. No guarantees. No interpretation.

OpenAPI (fixed contract): openapi.yaml (download)

Endpoint

GET /v1/abuse-signals

Query parameters

Name	Type	Required	Description
`email`	string	No	Email address to analyze (domain will be extracted)
`domain`	string	No	Domain name to analyze

At least one of email or domain must be provided.

Response

{
  "input": {
    "email": "test@tempmail.xyz",
    "domain": "tempmail.xyz"
  },
  "abuseScore": 82,
  "signals": [
    "disposable_domain_pattern",
    "low_domain_age",
    "shared_asn_with_abuse"
  ],
  "version": "v1"
}

Signals

Signal	Description
`disposable_domain_pattern`	Domain matches patterns commonly used by disposable/temporary providers
`low_domain_age`	Recently registered or unstable domain (when determinable)
`shared_asn_with_abuse`	Infrastructure shared with ASN historically associated with abuse

Signals are indicators, not verdicts.

Example (curl)

curl "https://api.yourdomain.com/v1/abuse-signals?email=test@tempmail.xyz" \
  -H "X-API-Key: YOUR_API_KEY"

Disclaimer

This API provides automated indicators based on infrastructure signals only. It does not provide legal, financial, or security advice. Accuracy is not guaranteed.

Pricing • Prod checklist