Erase stored verification records (data privacy)

POST

/v1/erasures

Data-privacy erasure API — permanently removes stored verification records for the supplied email addresses. (Renamed from /v1/delete for clarity.) See https://developers.mailfloss.com for the public docs.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Delete acknowledgement

Bodyapplication/json

🟠400

🟠401

🟠403

🟠409

🟠422

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/erasures' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "emails": [
        "string"
    ]
}'

Response Example

200 - Success

{
    "status": "success"
}

Modified at 2026-10-20 13:54:45

Delete a keyword rule

ErrorEnvelope