Get current user account information

The response shape differs from other endpoints: the user object sits at the top level under user, not under data.

user.quota is the part integrators need most, because it bounds the behaviour of other endpoints:

syncBaseConcurrent / syncPaidConcurrent — their sum is the concurrency limit for /api/tts/simple-generate

asyncBaseConcurrent / asyncHPConcurrent — concurrency allowance for asynchronous generation

lora — remaining professional-cloning quota; at 0, sending lora to POST /api/voice returns BILLING_QUOTA_EXCEEDED. user.loraQuota is the remaining professional-clone count; quota.lora mirrors the same number

priority — priority of asynchronous jobs

There are two credit fields — don't confuse them and don't use the wrong name. credit is the paid balance on the main account and bonusCredit is granted credit; front-ends usually display their sum. credits (with an s) is a legacy alias of bonusCredit and is deprecated, kept only for older clients — do not use it in new integrations.

Several fields are redacted or trimmed for privacy: phone may be masked or omitted, placeholder emails derived from phone numbers are rewritten, and password / frozenCredit / options are never returned. notifications is the unread count, but becomes the string "99+" past 99 — it can be either a number or a string, so parse defensively.

INFO

See the Errors document for the full code reference. Always use the X-Vocu-App-Request-Id response header when troubleshooting.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200Successfully retrieved user account information

application/json

Account info; the user object is at the top level under user, not data

Bodyapplication/json

Example

{
    "status": 200,
    "message": "OK",
    "user": {
        "id": "7249c3e5-10d5-4b5d-acc2-000a8cc0e358",
        "name": "p1pscp30",
        "email": "[email protected]",
        "phone": "191****3326",
        "avatar": "https://picsum.photos/seed/T9mWjQIssH/3653/564",
        "role": "user",
        "isPaid": true,
        "notifications": "20",
        "credits": 81
    }
}

🟠401Unauthorized

🟠429Rate limited

Get current user account information

Request

Request Code Samples

Responses