← All API sections

Account

Account management, GDPR export and deletion

4 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
POST/v1/account/restorePOST /v1/account/restore - call off a scheduled deletion

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. Stops the account sending immediately and schedules the erasure.

Responses

StatusDescription
202Account deletion scheduled
401Unauthorized
422Missing X-Confirm-Delete header

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)

POST /v1/account/restore

POST /v1/account/restore - call off a scheduled deletion

Responses

StatusDescription
200Deletion cancelled
401Unauthorized
404No deletion was pending

Example

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

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

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

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

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

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

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

result, err := client.CreateAccount(ctx)