API Reference

Verify if an email address is from a disposable email service.

Status: Active

smart_toy Integrate With AI

Copy a ready-made prompt for Claude Code or any AI coding agent. It wires the disposable-email check into your signup flow and stores your key as an environment variable — nothing hardcoded.

code Send To A Developer

Not doing this yourself? Copy the link to the full developer documentation to share directly with whoever is wiring this up.

Endpoints

Use /check, /health, and /limit to verify emails and monitor your usage.

Base URL

https://tempo-checker.rami-dev.com/v1

Authentication

Note: The API key 3d0ccdc4-2cbe-44c2-a632-43a5d944e537 shown below is a dummy testing key. It allows developers to safely integrate and test the API without consuming any real credits. It will always return dummy responses.

Include your API key in the Authorization header:

Authorization: Bearer 3d0ccdc4-2cbe-44c2-a632-43a5d944e537

Response Time

Typical: 100-500ms

Max: 5 seconds

# 1. Check if email is from a disposable email service
curl -X GET "https://tempo-checker.rami-dev.com/v1/check?email=user@example.com" \
  -H "Authorization: Bearer 3d0ccdc4-2cbe-44c2-a632-43a5d944e537"

# 2. Check API health status
curl -X GET https://tempo-checker.rami-dev.com/v1/health

# 3. Check your API limits
curl -X GET https://tempo-checker.rami-dev.com/v1/limit \
  -H "Authorization: Bearer 3d0ccdc4-2cbe-44c2-a632-43a5d944e537"
Expected /check Response (200 OK)
{
  "email": "user@example.com",
  "canonical_email": "user@example.com",
  "domain": "example.com",
  "valid_syntax": true,
  "disposable": false,
  "free": false,
  "has_mx_record": true,
  "risk_score": 0.0,
  "reason": "none"
}

Live API Playground

Test the API directly from the browser using the public dummy key.

Tip: This playground uses the dummy testing key. You will not be charged any credits, and the responses are simulated.

Response Examples

Legitimate Email

{
  "status": "success",
  "email": "john@company.com",
  "is_disposable": false,
  "provider": "company.com",
  "valid": true,
  "confidence": 0.99
}

Disposable Email

{
  "status": "success",
  "email": "temp@tempmail.com",
  "is_disposable": true,
  "provider": "tempmail.com",
  "valid": false,
  "confidence": 0.98
}