Skip to content

Get your account profile

GET
/v1/account/profile

Returns your account profile including credit balance, email verification status, connected OAuth providers, and credit expiry date. Use this to check your balance before making generation requests.

OK

Media type application/json
object
user

User profile data.

object
account_status

Active: the account may use the whole service. suspended: the account is suspended (Terms §4.8); API keys are refused, and a dashboard session reaches only the profile, billing and payment history, the withdrawal function, data export and account closure, and listing and revoking its API keys, not creating one (other calls answer 403 auth_account_suspended). An API key only ever sees active.

string
Allowed values: active suspended
balance_eur

Current balance in credits (EUR, excluding VAT; 6 decimal places). Includes pending holds — this is the available (spendable) balance.

string
created_at

ISO 8601 account creation timestamp.

string
credit_limit_cents

Per-transaction/balance credit limit, in cents of credits (EUR, excluding VAT).

integer
credits_expire_at

ISO 8601 timestamp when credits expire.

null | string
email

User’s email address.

string
email_verified

Whether the email is verified.

boolean
free_trial_pending_eur

Free credits pending email verification, in credits (EUR, excluding VAT). Present only when the user registered while free trials were active and has not yet verified.

null | string
held_eur

Amount currently held by in-flight generations, in credits (EUR, excluding VAT; 6 decimal places). Zero when no generations are running.

string
id

User UUID.

string
name

Display name.

null | string
pending_credit_notice

True when there are unseen credit grants. Dismiss via POST /v1/account/notifications/dismiss.

boolean
prompt_analysis_opt_in

Whether the user opted in to prompt analysis.

boolean
providers

Connected OAuth providers.

Array<string> | null
self_service_data_actions

Whether the account can export its data and close itself from the dashboard. When false, both are handled on request through privacy@depicta.ai: the dashboard shows that instead of the controls, and the export and closure endpoints answer 403 account_export_unavailable and account_closure_unavailable.

boolean
two_factor_enabled

Whether 2FA is enabled.

boolean

Bad Request

Media type application/json
object
details
error
string
message
string
request_id
string

Unauthorized

Media type application/json
object
details
error
string
message
string
request_id
string

Payment Required

Media type application/json
object
details
error
string
message
string
request_id
string

Forbidden

Media type application/json
object
details
error
string
message
string
request_id
string

Not Found

Media type application/json
object
details
error
string
message
string
request_id
string

Conflict

Media type application/json
object
details
error
string
message
string
request_id
string

Unprocessable Entity

Media type application/json
object
details
error
string
message
string
request_id
string

Too Many Requests

Media type application/json
object
details
error
string
message
string
request_id
string

Unavailable For Legal Reasons

Media type application/json
object
details
error
string
message
string
request_id
string

Internal Server Error

Media type application/json
object
details
error
string
message
string
request_id
string

Bad Gateway

Media type application/json
object
details
error
string
message
string
request_id
string

Service Unavailable

Media type application/json
object
details
error
string
message
string
request_id
string