API Reference
Verify if an email address is from a disposable email service.
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
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"
{
"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
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
}