PayphonePayphone
Api reference

Account snapshot

Returns credit balance, trial state, tier, and contact cache for the authenticated account. **Auth:** Privy session JWT or any valid `dial_live_*` / `dial_test_*` API key (no extra scope). Use this to verify an agent key after onboarding.

Returns credit balance, trial state, tier, and contact cache for the authenticated account.

Auth: Privy session JWT or any valid dial_live_* / dial_test_* API key (no extra scope). Use this to verify an agent key after onboarding.

GET
/api/v1/account

Authorization

bearer
AuthorizationBearer <token>

Privy access token (dashboard sessions, ~1h TTL) or long-lived dial_live_* / dial_test_* API key minted from /dashboard/billing. API keys are scope-gated per route (sms:send, numbers:read, account:read, etc.); Privy sessions bypass scope checks. See /docs/api-reference/api-keys for the full scope catalogue.

In: header

Response Body

application/json

curl -X GET "https://payphone.wtf/api/v1/account"
{
  "privyUserId": "string",
  "credits": 0,
  "totalCredits": 0,
  "authMethod": "privy",
  "apiKeyPrefix": "string"
}
Empty