5-Minute Quickstart
Get up and running with PureSignup in less than 5 minutes. No complex setup, no dependencies—just one simple API call.
New to PureSignup? Start with a demo to test the API without signing up.
Step 1: Get Your API Key
- Create an account and start your 7-day free trial
- Complete your profile
- Navigate to Account → Settings → API Keys
- Click Create New Key
- Copy your key immediately (it's only shown once!)
Your API key will look like: sk_1234567890abcdef...
Step 2: Make Your First Request
Test your API key with a simple cURL request:
Test with cURL
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://puresignup.com/api/v1/check?q=user@guerrillamail.com"You should see a response like this:
Response (High Risk)
{
"success": true,
"data": {
"subject": "user@guerrillamail.com",
"subject_type": "email",
"risk_level": "high",
"domain": "guerrillamail.com",
"sources": ["SRC_A", "SRC_B", "SRC_E"],
"last_updated": "2025-11-17T18:29:54.827Z",
"checked_at": "2025-11-17T18:30:00.000Z"
}
}Now try with a legitimate email provider:
Test with legitimate email
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://puresignup.com/api/v1/check?q=user@gmail.com"Response (Low Risk)
{
"success": true,
"data": {
"subject": "user@gmail.com",
"subject_type": "email",
"risk_level": "low",
"domain": "gmail.com",
"checked_at": "2025-11-17T18:30:00.000Z"
}
}Step 3: Integrate Into Your App
Choose your preferred language or framework to integrate PureSignup into your signup flow:
JavaScript / Frontend
Validate emails in real-time as users type
Node.js / Express
Server-side validation with async/await
Python / Flask / Django
Integrate with Python backends
PHP / Laravel
Add validation to PHP applications
Quick Integration Example
Here's a minimal JavaScript example to get you started:
JavaScript Example
async function checkEmail(email) {
const response = await fetch(
'https://puresignup.com/api/v1/check?q=' + encodeURIComponent(email),
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
if (data.success && data.data.risk_level === 'high') {
alert('Disposable email detected! Please use a permanent email.');
return false;
}
return true;
}
// Usage in your signup form
document.getElementById('signupForm').addEventListener('submit', async (e) => {
e.preventDefault();
const email = document.getElementById('email').value;
if (await checkEmail(email)) {
// Email is valid, proceed with signup
e.target.submit();
}
});Understanding the Response
Every API response includes these key fields:
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the request was successful |
data.subject | string | The email/domain you checked |
data.subject_type | string | "email" or "domain" |
data.risk_level | string | "high" (disposable) or "low" (legitimate) |
data.domain | string | The domain extracted from the email |
data.sources | array | List of sources that flagged this domain (high risk only) |
data.checked_at | string | ISO 8601 timestamp of when the check was performed |
Best Practices
Check server-side: Always validate on your backend to prevent
bypassing
Handle errors gracefully: Don't block signups if the API
is unavailable
Keep your API key secure: Never expose it in frontend code
or public repos
Next Steps
- Explore the full API reference
- Learn about error handling
- See our 160,000+ domain sources
- View pricing plans and upgrade for higher limits