API Reference

current-user

1 endpoint

GET/api/v1/users/me

Get Current User

Get the currently authenticated user.

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field

Type

Description

uuid*

string

User UUID

username

string | null

Username (set during onboarding)

first_name

string | null

First name (set during onboarding)

last_name

string | null

Last name

phone_number

string | null

Phone number

avatar_image_file_url

string | null

Avatar image URL

created_at*

string (date-time)

Account creation timestamp

iam_user_id

string | null

IAM user ID (without 'iam:' prefix)

string | null

Email address from auth provider

email_verified

boolean | null

Whether email is verified

scopes

string[]

Granted permission scopes

wallet_address

string | null

Primary wallet address

primary_card_identifier

string | null

Primary card identifier (e.g., NFC serial number)

profile_complete*

boolean

Whether user has completed their profile setup

onboarding_required

boolean

Whether user needs to complete onboarding

default: false

subscription*

CurrentSubscriptionResponse

The user's subscription tier and entitlements

object · CurrentSubscriptionResponse

Field

Type

Description

tier*

string

display_name*

string

status*

string

started_at*

string (date-time)

valid_until

string (date-time) | null

entitlements*

Entitlements

object · Entitlements

Field	Type	Description
custom_backgrounds	boolean	default: false
max_profiles	integer	default: 1
extras	object

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

404Resource not found

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/users/me" \
  -H "Authorization: Bearer <token>"