Read the authenticated organization

GET

/v1/organization

Returns plan, named credit buckets (prepaid + subscription), current-period usage, contact email, and status for the org the API key belongs to. Scoped implicitly to the authenticated org — no :id path parameter. Idempotent read; no credit consumption. Unlike credit-consuming endpoints, this read still succeeds for a restricted account (suspended / paused / under_review / needs_identity_verification) and reports the state in status — so an automated client can detect, for example, a billing suspension and act on it. A banned account is the one exception: it returns 403 forbidden.

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 organization

Bodyapplication/json

🟠401

🟠403

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "name": "Acme Corp",
    "email": "jane@acme.com",
    "plan": "pro",
    "plan_id": "price_1A2b3C4d5E6f7G8h",
    "credits": {
        "prepaid": 10000,
        "subscription": 5000,
        "total": 15000
    },
    "usage": {
        "current_period_start": "2026-06-01T00:00:00Z",
        "current_period_end": "2026-07-01T00:00:00Z",
        "current_period_total": 2400
    },
    "trial": {
        "active": false,
        "started_at": null,
        "ends_at": null
    },
    "created_at": "2026-01-15T09:00:00Z",
    "status": "active",
    "entitlements": {
        "webhooks": true,
        "instafloss": true,
        "typo_fixer": true,
        "exclusions": true,
        "update_tags": true,
        "sso": true,
        "autofloss": true,
        "decay_basic": true,
        "decay_custom": false
    }
}

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

Update the authenticated account holder

List team members