Skip to main content

​
GET /api/v1/users/me

Return the profile for the currently authenticated user.

​
Response

​
id
string
UUID of the user account.
​
email
string
Account email address.
​
full_name
string
Display name. null if not set.
​
is_active
boolean
Whether the account is active.
​
role
string
Account role. Returns "user" for standard accounts.
​
subscription_tier
string
Current subscription tier: "developer" or "pro".
​
subscription_status
string
Subscription lifecycle status: "active", "inactive", "past_due", etc.
​
current_period_end
string
ISO 8601 timestamp when the current billing period ends. null for free/developer accounts.
​
permanent_credit_balance
integer
Non-expiring credit balance.
​
api_key_last_four
string
Last four characters of your API key. null if no key has been generated.
​
referral_code
string
Your unique referral code.

​
Example

cURL
curl https://api.deepcurrent.app/api/v1/users/me \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "alice@example.com",
  "full_name": "Alice",
  "is_active": true,
  "role": "user",
  "subscription_tier": "pro",
  "subscription_status": "active",
  "current_period_end": "2026-05-08T00:00:00Z",
  "permanent_credit_balance": 4200,
  "api_key_last_four": "7x9z",
  "referral_code": "dc_abcdefgh"
}

​
PATCH /api/v1/users/me

Update your profile. Only the fields you include are changed.

​
Request body

​
full_name
string
New display name. Maximum 255 characters.
​
email
string
New email address. Returns 409 Conflict if the address is already in use.

​
Response

Returns the updated user profile in the same shape as GET /api/v1/users/me.

​
Example

cURL
curl -X PATCH https://api.deepcurrent.app/api/v1/users/me \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "full_name": "Alice Smith" }'
Response
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "alice@example.com",
  "full_name": "Alice Smith",
  "role": "user",
  "subscription_tier": "pro",
  "subscription_status": "active",
  "permanent_credit_balance": 4200,
  "referral_code": "dc_abcdefgh"
}