profiles

Get public user profile

Get a user's public profile by their handle.

This is a public endpoint - no authentication required.

Returns 404 if:

The response includes:

handle: The user's handle
created_at: When the account was created
stats: Aggregated tip statistics (sent/received counts and totals)
earning_addresses: Wallet addresses that can earn tips (Smart Account wallets)
social_links: Linked social profiles (Twitter, GitHub, etc.)

get/v1/profiles/{handle}

Request

Base URL
https://api.grove.city (the document declares no server; this is the origin it was published from)
URL
https://api.grove.city/v1/profiles/{handle}
Auth
none declared

handlestring required

User handle (case-insensitive)

Successful Response

handlestring required

User's handle (e.g., 'alice')

descriptionstring nullable

Profile bio (max 280 characters)

avatar_urlstring nullable

User-selected avatar URL from verified social identity

created_atstring required

Account creation date (ISO 8601)

referral_codestring nullable

User's shareable referral code (e.g., 'GRV-ABC123')

tip_to_talk_minnumber nullable

Minimum tip in USD for paid messages (Tip to Talk). NULL = disabled.

is_claimedboolean

Whether this profile has been claimed by the creator. Pre-registered profiles are unclaimed until the creator authenticates.

tip_button_labelstring

CTA label for the tip button on the profile page. Feed/content contexts should always show 'Tip' regardless.

{
  "theme": {
    "accent_color": "#4CAF50",
    "preset": "dark"
  }
}

No recorded changes to this operation across all 1 revision of this API.