Read the authenticated account holder

GET

/v1/account

Returns the account holder's identity and security posture — name, email, email_verified, two_factor_enabled, country, and signup date — for the account the API key belongs to. Complements GET /v1/organization (plan/credits/usage) and GET /v1/users/me (the holder as a team-roster seat). Scoped implicitly to the authenticated account — no path parameter. Idempotent read; no credit consumption.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200

application/json

Authenticated account holder

Bodyapplication/json

🟠401

🟠403

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.mailfloss.com/v1/account' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "id": "usr_amFuZUBhY21lLmNvbQ",
    "name": "Jane Smith",
    "email": "jane@acme.com",
    "email_verified": true,
    "two_factor_enabled": true,
    "identity_verified": "verified",
    "phone": "+1-415-555-0142",
    "organization": "Acme Corp",
    "vat_id": null,
    "country": "US",
    "address": {
        "line1": "500 Market St",
        "line2": null,
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105",
        "country": "US"
    },
    "notifications": {
        "after_flossing": true,
        "weekly_report": false,
        "monthly_report": false,
        "payment_receipts": true
    },
    "created_at": "2026-01-15T08:45:00Z"
}

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

Verify an API key

Update the authenticated account holder