API Documentation

Try on RapidAPI

Use the hosted playground to send authenticated requests without writing code.

Open RapidAPI Playground

OpenAPI Reference

Browse endpoints and schemas with an interactive viewer.

Open OpenAPI Reference

What is the OpenAPI page?

It is a machine‑readable spec plus an interactive viewer. It powers SDKs, code generation, testing tools, and makes it easy for developers to see every endpoint and response in one place.

• Use Download spec to import into Postman/Insomnia or generate clients.
• Use Open Playground on RapidAPI to send authenticated requests in the browser.

Pro response example

Paid plans return extended fields. Example shape:

{
  "disposable": true,
  "risk_score_basic": 93,
  "decay_score": 12,
  "family": "tempmail",
  "tld_risk": "high",
  "mx_present": true,
  "mx_fp": "mx.tempmailo.com",
  "last_ct_seen": "2025-08-12T10:00:00Z",
  "plan": "pro",
  "rate": {"remaining": null, "reset_at": "2025-09-01T00:00:00Z"}
}

Authentication

Use one of:

• RapidAPI: send header X-RapidAPI-Proxy-Secret: YOUR_SECRET
• Direct (optional for later): X-Api-Key: YOUR_KEY

Free plan responses include an attribution header and field; paid plans do not.

GET /v1/domain/check?domain=example.com

Checks a domain for disposable risk.

curl -s "https://api.disposableintel.com/v1/domain/check?domain=temp-mail.org" -H "X-RapidAPI-Proxy-Secret: YOUR_SECRET"

Response (Free):

{
  "disposable": false,
  "risk_score_basic": 42,
  "plan": "free",
  "rate": {"remaining": null, "reset_at": "YYYY-MM-DDT00:00:00Z"},
  "attribution": "https://disposableintel.com"
}

Response (Pro/Business adds): decay_score, family, tld_risk, mx_present, first_seen, last_seen, provenance, version

GET /v1/email/[email protected]

curl -s "https://api.disposableintel.com/v1/email/check?email=user%40tempmailo.com" -H "X-RapidAPI-Proxy-Secret: YOUR_SECRET"

GET /v1/list.json and /v1/list.csv

Returns a limited subset (Top‑500) for demos. Full dataset is a paid add-on (later).

curl -s "$API_BASE/v1/list.json"

GET /health

Reports liveness/readiness and snapshot metadata.

GET /v1/usage

Shows current usage for the authenticated key (placeholder in MVP).

GET /stats

Aggregate counters for status widgets (requests today, cache hit ratio).

curl -s "https://api.disposableintel.com/stats"

GET /v1/ct/candidates

CT = Certificate Transparency. We monitor recent TLS certificates and extract hostnames to spot newly active base domains linked to disposable email. “CT‑derived candidates” are provisional domains from CT logs (heuristic, TTL‑based) that are not yet fully verified.

curl -s "https://api.disposableintel.com/v1/ct/candidates?limit=20"

GET /v1/ct/confirmed

“CT‑confirmed” are candidates that pass simple thresholds (repeat sightings and/or MX presence). Confirmed domains are promoted for 7 days (TTL) and feed into risk scoring and examples.

curl -s "https://api.disposableintel.com/v1/ct/confirmed?limit=20"

Popular lookups

curl -s "https://api.disposableintel.com/v1/domain/check?domain=temp-mail.org" \
  -H "X-RapidAPI-Proxy-Secret: YOUR_SECRET"

{
  "disposable": true,
  "risk_score_basic": 92,
  "plan": "free",
  "rate": {"remaining": null,"reset_at":"YYYY-MM-01T00:00:00Z"},
  "attribution":"https://disposableintel.com"
}

{
  "disposable": true,
  "domain": "tempmailo.com",
  "risk_score_basic": 88,
  "plan": "free",
  "rate": {"remaining": null,"reset_at":"YYYY-MM-01T00:00:00Z"},
  "attribution":"https://disposableintel.com"
}