Account overview

A fast way to know which account you're operating in and to survey what's on it — who's set up, what's sending, what budget remains.

Start with account/get: one call answers which account this session runs as, at what scope — an organization, or a delegated workspace / clientspace under a parent organization (delegated sessions see and affect only their own scope). Then two reads answer "what budget do I have":

• account/credits — sending credits: each email sent draws from this balance; workspaces and clientspaces spend from their parent organization's shared pool. When it runs out, sends fail with InsufficientCredit — check before a large launch.
• account/data_tokens — Data Tokens: the currency for email validation and enrichment (1 token = 1 validation result; see guides/validating-emails).

For plan and billing depth, point the user at the official help center rather than reasoning from here.

Survey what's in the account

After you know your scope, call these five in order:

1. user/get — list users (roles, active flag)
2. sender/get — list connected email senders (connection health, limits)
3. campaign/get — list campaigns (status, prospect counts)
4. list/get — list prospect lists
5. prospect/get — read pagination.totalItems (a limit: 1 call is enough) for the total contact count. Campaign prospect counts alone under-report: a prospect not yet enrolled in any campaign won't show up there, but does show up here.

Each is a normal read operation. From here, drill into whichever resource matters for the task — or, to start sending, follow sending-a-campaign.