Account
Account management, GDPR export and deletion
4 endpoints
Endpoints
Method Path Description
GET /v1/accountGet current account info and quota usage
DELETE /v1/accountGDPR account deletion
GET /v1/account/exportGDPR data export
POST /v1/account/restorecall off a scheduled deletion
GET /v1/account
Get current account info and quota usage
Responses
Status Description
200 Account details with quota usage
401 Unauthorized
Example
cURL
TypeScript
Python
Rust
Go
curl -X GET https://api.euromail.dev/v1/account \
-H "Authorization: Bearer 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
Status Description
202 Account deletion scheduled
401 Unauthorized
422 Missing X-Confirm-Delete header
Example
cURL
TypeScript
Python
Rust
Go
curl -X DELETE https://api.euromail.dev/v1/account \
-H "Authorization: Bearer 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
Streams every row the account owns in every customer-data table as one
JSON document; see [euromail_common::account_export] for the sections
and the few credential columns left out. Rate limited to 1 per hour.
Responses
Status Description
200 GDPR data export, sent as a file download
401 Unauthorized
429 Export rate limited (1 per hour)
Example
cURL
TypeScript
Python
Rust
Go
curl -X GET https://api.euromail.dev/v1/account/export \
-H "Authorization: Bearer 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
call off a scheduled deletion
Responses
Status Description
200 Deletion cancelled
401 Unauthorized
404 No deletion was pending
Example
cURL
TypeScript
Python
Rust
Go
curl -X POST https://api.euromail.dev/v1/account/restore \
-H "Authorization: Bearer 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)