Remove Personal Data

Data Removal with VerifyEmail.io

Data Removal Guide

Learn how to submit data removal requests using our simple API endpoints.

✨ Basic Removal Request

Our data removal endpoint helps you submit removal requests for personal information:

POST https://verifyemail.io/api/removal

Example Request Payload:


{
    "email": "test@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "state": "California",
    "requestType": "Opt Out",
    "source": "API"
}

💻 Code Examples


import requests

def submit_removal_request(email, first_name, last_name, state="", request_type="Opt Out"):
    url = "https://verifyemail.io/api/removal"
    data = {
        "email": email,
        "firstName": first_name,
        "lastName": last_name,
        "state": state,
        "requestType": request_type
    }
    
    response = requests.post(url, json=data)
    return response.json()

# Example usage
result = submit_removal_request(
    "test@example.com",
    "John",
    "Doe",
    "California",
    "Opt Out"
)
print(result)


async function submitRemovalRequest(email, firstName, lastName, state = "", requestType = "Opt Out") {
    const url = 'https://verifyemail.io/api/removal';
    const data = {
        email,
        firstName,
        lastName,
        state,
        requestType
    };
    
    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(data)
        });
        return await response.json();
    } catch (error) {
        console.error('Removal request failed:', error);
        throw error;
    }
}

// Example usage
submitRemovalRequest('test@example.com', 'John', 'Doe', 'California', 'Opt Out')
    .then(result => console.log(result))
    .catch(error => console.error(error));


function submitRemovalRequest($email, $firstName, $lastName, $state = "", $requestType = "Opt Out") {
    $url = "https://verifyemail.io/api/removal";
    $data = json_encode([
        'email' => $email,
        'firstName' => $firstName,
        'lastName' => $lastName,
        'state' => $state,
        'requestType' => $requestType
    ]);
    
    $options = [
        'http' => [
            'method' => 'POST',
            'header' => 'Content-Type: application/json',
            'content' => $data
        ]
    ];
    
    $context = stream_context_create($options);
    $response = file_get_contents($url, false, $context);
    return json_decode($response, true);
}

// Example usage
$result = submitRemovalRequest(
    'test@example.com',
    'John',
    'Doe',
    'California',
    'Opt Out'
);
print_r($result);

📝 Request Parameters

Required Parameters:

email: The email address to be removed

Optional Parameters:

firstName: First name of the individual
lastName: Last name of the individual
state: State of residence
requestType: Type of request (default: "Opt Out")
source: Source of the request

📄 Response Format

Here's what you'll receive back from a successful removal request:


{
    "SUCCESS": true,
    "MESSAGE": "Your information removal request has been processed successfully."
}

🎯 Actions Taken

When a removal request is processed:

All matching contact records are marked as inactive
Associated email addresses are marked as removed
A confirmation email is sent to the requestor
The request is logged for compliance purposes

💡 Best Practices

Always provide as much information as possible to ensure accurate removal
Include state information for compliance with state privacy laws
Store the response for your records
Handle API responses gracefully in your application

Was this helpful?

Please log in to provide feedback.

Last updated: Jan 19, 2025 2:18 PM
Created: Jan 19, 2025 2:12 PM by VerifyEmail.io Support

In This Category