← All API sections

Account

Account management, GDPR export and deletion

3 endpoints

Endpoints

MethodPathDescription
GET/v1/accountGET /v1/account - Get current account info and quota usage
DELETE/v1/accountDELETE /v1/account - GDPR account deletion
GET/v1/account/exportGET /v1/account/export - GDPR data export

GET /v1/account

GET /v1/account - Get current account info and quota usage

Responses

StatusDescription
200Account details with quota usage
401Unauthorized

Example

curl -X GET https://api.euromail.dev/v1/account \
  -H "X-EuroMail-Api-Key: em_live_..."
import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.listAccounts();
from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.list_accounts()
use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.list_accounts().await?;
client := euromail.NewClient("em_live_...")

result, err := client.ListAccounts(ctx)

DELETE /v1/account

Requires X-Confirm-Delete: DELETE header. Deactivates the account immediately and enqueues cascading data deletion.

Responses

StatusDescription
202Account deletion accepted
400Missing X-Confirm-Delete header
401Unauthorized

Example

curl -X DELETE https://api.euromail.dev/v1/account \
  -H "X-EuroMail-Api-Key: em_live_..."
import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.deleteAccount();
from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.delete_account()
use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.delete_account().await?;
client := euromail.NewClient("em_live_...")

result, err := client.DeleteAccount(ctx)

GET /v1/account/export

Returns a JSON export of all account data (no email bodies). Rate limited to 1 per hour via Redis key.

Responses

StatusDescription
200GDPR data export
401Unauthorized
429Export rate limited (1 per hour)

Example

curl -X GET https://api.euromail.dev/v1/account/export \
  -H "X-EuroMail-Api-Key: em_live_..."
import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.getAccount();
from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.get_account()
use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.get_account().await?;
client := euromail.NewClient("em_live_...")

result, err := client.GetAccount(ctx)